SDK 연동

실제로 지원하는 텍스트 엔드포인트에 OpenAI 호환 SDK를 사용하세요. SDK의 base_url에는 API 원점 뒤에 /v1을 붙입니다. 원점 자체에는 버전 접미사가 없습니다. 모델에는 현재 키의 카탈로그에 있는 공개 ID를 계속 사용합니다.

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GLOOP_API_KEY"],
    base_url=os.environ["GLOOP_API_BASE"].rstrip("/") + "/v1",
    max_retries=0,
)
response = client.chat.completions.create(
    model=os.environ["GLOOP_MODEL"],
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

JavaScript

import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: process.env.GLOOP_API_KEY,
  baseURL: process.env.GLOOP_API_BASE.replace(/\/$/, '') + '/v1',
  maxRetries: 0,
});
const response = await client.chat.completions.create({
  model: process.env.GLOOP_MODEL,
  messages: [{ role: 'user', content: '你好' }],
});
console.log(response.choices[0].message.content);

이 예제는 네트워크 중단 후 확인 없이 유료 요청을 다시 제출하지 않도록 자동 재시도를 비활성화합니다. 특정 엔드포인트의 멱등성 계약에 따라서만 재시도를 활성화하세요. 플랫폼이 모든 SDK 호출의 중복을 제거한다고 가정하지 마세요.

플랫폼 전용 엔드포인트

이미지 견적, 영구 보관 작업, 도구와 파일에는 일반 HTTP 클라이언트를 사용하세요. client.image_tasks.create처럼 존재하지 않는 SDK 메서드를 호출하지 마세요. 엔드포인트 페이지는 JSON, multipart, SSE와 바이너리 응답을 구분하여 cURL, requests와 fetch 예제를 제공합니다.

오디오 응답은 바이트로 저장하고 이미지 업로드의 multipart boundary는 클라이언트가 생성하도록 하며 스트리밍 응답은 이벤트별로 파싱하세요. 사용자 지정 API 필드는 엔드포인트가 명시적으로 지원하는 경우에만 전달하세요. SDK 호환성이 모든 OpenAI 기능의 가용성을 뜻하지는 않습니다. 먼저 스트리밍 가이드와 비동기 복구를 읽으세요.