OpenAI 호환

OpenAI 호환 API와 함께 OpenAI SDK 사용

Python과 JavaScript로 빌드하세요.

3단계로 연결

1. API 키 생성

IteraCompute 계정을 생성하거나 로그인한 다음 콘솔에서 키를 생성하세요.

2. 기본 URL 구성

Python에서 base_url을 설정하거나 JavaScript에서 baseURL을 설정한 다음 채팅 완료를 사용하세요.

3. 모델을 선택하세요

선택한 모델에 대한 정확한 API 모델 ID를 사용하세요.에이전트 또는 비전 기능을 활성화하기 전에 해당 컨텍스트와 기능을 확인하세요.

모델을 선택하세요

예시 구성

서버 환경이나 도구 자격 증명 저장소에 API 키를 보관하세요.해당하는 경우 예제 키 필드를 사용자 고유의 키로 바꿉니다.

OpenAI 호환 API
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.iteracompute.com/v1",
    api_key=os.environ["ITERACOMPUTE_API_KEY"],
)
response = client.chat.completions.create(
    model="qwen/qwen3.8-27b",
    messages=[{"role": "user", "content": "Hello!"}],
    max_tokens=512,
    extra_body={"chat_template_kwargs": {"enable_thinking": False}},
)
text = response.choices[0].message.content
if not text or not text.strip():
    raise RuntimeError("Empty model reply: activation is incomplete.")
print(text)

버전 및 검증

Python SDK 2.14.0 · Python 3.11.4 · 2026년 10월 15일: 요청 직렬화 및 비어 있지 않은/빈 응답 처리가 로컬 모의 전송으로 확인되었습니다.이는 실제 API 호출을 설정하지 않습니다.JavaScript SDK 버전과 엔드투엔드 결과는 아직 기록되지 않았습니다.

성공 기준

두 SDK 조각을 모두 실행합니다.각각은 비어 있지 않은 콘텐츠를 인쇄해야 합니다.키가 없거나 빈 응답이 있으면 프로그램을 중지해야 합니다.

설치된 버전 기록
python -m pip show openai
npm ls openai

아래 API 확인 후 구성된 도구 자체를 테스트해 보세요.HTTP 200 또는 cURL 결과만으로는 해당 도구를 확인할 수 없습니다.

연결 테스트

cURL · 채팅 완료
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
  -H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'

choice[0].message.content에 보이는 텍스트가 포함되어 있는지 확인하세요.HTTP 200만으로는 부족합니다.추론은 출력 예산을 소비할 수 있습니다.무료 Qwen을 사용하려면 다음을 사용하세요. 첫 번째 무료 통화 예시 사고를 비활성화하려면 도구 내부에 메시지를 보내세요.

선택된 모델 기능

선택한 모델의 API 기능입니다.워크플로의 기능 가용성은 도구 및 해당 설정에 따라 달라집니다.추론 제어는 모델에 따라 다릅니다.

  • 채팅 완료지원됨
  • 도구 호출지원됨
  • 추론지원됨
  • 이미지 입력지원됨
  • 스트리밍지원됨

문제 해결

잘못된 기본 URL

Python은 base_url을 사용합니다.JavaScript는 baseURL을 사용합니다.IteraCompute 키를 명시적으로 전달합니다. SDK 기본 환경 변수는 ITERACOMPUTE_API_KEY가 아닙니다.

잘못된 엔드포인트

client.chat.completions.create를 호출하고 선택사항[0].message.content를 읽습니다.응답 예제와 response.output_text는 다른 API를 사용합니다.

HTTP 200, 빈 텍스트

빈 콘텐츠 필드는 성공적인 텍스트 테스트가 아닙니다.무료 Qwen 예제는 512개의 출력 토큰을 허용하고 사고를 비활성화합니다.이 매개변수는 모델별로 다릅니다.

429 / 요청 제한

계정 전체의 월간 사용량과 TPM을 확인하세요.이후 재시도를 존중하고 병렬 재시도를 방지합니다.무료 Qwen에는 자동으로 지불되는 초과분이 없습니다.다른 모델은 게시된 가격을 사용합니다.

401 / 403 : 키와 모델 권한을 확인하세요.무료 Qwen에는 잔액이나 카드가 필요하지 않습니다.유료 모델의 경우 사용 가능한 잔액도 확인하세요.

OpenAI SDK 구성 참조 →

OpenAI SDK로 구축을 시작하세요.

키를 연결하고 모델을 선택한 후 첫 번째 요청을 보내세요.