한국어
EastX에 OpenAI Python SDK 연결하기｜첫 요청과 오류 해결
EastX의 OpenAI 호환 Chat Completions 엔드포인트를 이용하면 같은 SDK 연결에서 여러 모델을 비교할 수 있습니다. 콘솔에서 용도별 API 키를 만들고 잔액, 키 사용 한도, 모델 권한 및 발신 IP 제한을 확인하세요. 키는 환경 변수 `EASTX_API_KEY`에 보관하고 공개 코드나 스크린샷에 넣지 마세요.
API 키와 모델 준비
EastX의 OpenAI 호환 Chat Completions 엔드포인트를 이용하면 같은 SDK 연결에서 여러 모델을 비교할 수 있습니다. 콘솔에서 용도별 API 키를 만들고 잔액, 키 사용 한도, 모델 권한 및 발신 IP 제한을 확인하세요. 키는 환경 변수 EASTX_API_KEY에 보관하고 공개 코드나 스크린샷에 넣지 마세요.
모델 목록에서 텍스트 대화를 지원하는 모델의 정확한 ID를 복사하여 EASTX_MODEL 환경 변수에 설정합니다. 클라이언트별 키를 사용하면 사용량과 예산을 구분할 수 있습니다.
첫 요청 보내기
python -m pip install openai
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["EASTX_API_KEY"],
base_url="https://api.eastx.ai/v1",
timeout=60.0,
max_retries=0,
)
response = client.chat.completions.create(
model=os.environ["EASTX_MODEL"],
messages=[{"role": "user", "content": "한 문장으로 인사해 주세요."}],
)
print(response.choices[0].message.content)
print(response.usage)
응답을 받은 뒤 콘솔에서 시간과 모델에 해당하는 사용 기록을 확인합니다. 요청에는 요금이 발생할 수 있습니다. 모델을 바꿀 때는 스트리밍, 도구 호출, 이미지 입력 및 파라미터 지원 여부를 다시 확인하세요.
오류 해결
- 401: 유효한 키가 완전하게 입력되었는지 확인합니다.
- 402: 계정 잔액, 키 한도와 최대 출력에 대한 예상 비용을 각각 확인합니다.
- 403: 모델 권한과 발신 IP 제한을 확인합니다.
- 404: 모델 ID와 Base URL을 확인하고
/v1또는/chat/completions중복을 제거합니다. - 429: 동시 요청을 줄이고
Retry-After가 있으면 따르며 재시도 횟수를 제한합니다. - 5xx 또는 시간 초과: 시간과 비식별 요청 ID를 보관하고 작업 상태를 확인한 뒤 재시도합니다.