모든 게시물
엔지니어링

OpenAI 호환 API에서 ‘호환’의 의미

프로토타입 콘텐츠 미리보기. 그림, 저자 세부정보, 제품 주장 및 API 예시는 확인 대기 중입니다. 예는 통합 지침이 확인되지 않았습니다.

우리는 의도적으로 갈라지는 부분을 포함하여 OpenAI 호환성 레이어의 모든 끝점, 매개 변수 및 엣지 케이스를 살펴봅니다.

많은 게이트웨이가 OpenAI 호환성을 주장하고 사용자가 의존하는 표면적의 절반을 조용히 줄입니다. 이것이 바로 우리가 구현하는 것, 확장하는 것, 의도적으로 분기하는 부분입니다.

완전 지원

  • /v1/chat/completions: 스트리밍, tools, tool_choice 및 구조화된 출력 지원
  • /v1/embeddings: 배치 처리 지원
  • /v1/images/generations 및 이미지 편집
  • /v1/audio/transcriptions, 음성 번역 및 음성 합성
  • /v1/models: 제공업체를 명시한 ID 지원

한 줄로 전환

from openai import OpenAI

client = OpenAI(
    base_url="https://api.starsg.ai/v1",
    api_key=STARSG_API_KEY,
)

우리가 갈라지는 곳

세 가지 고의적인 차이점. 첫째, 모델 ID는 공급자 자격이 있으므로 동일한 이름이 두 가지를 의미하지 않습니다. 둘째, 속도 제한 헤더는 업스트림 공급업체의 제한이 아닌 풀링된 게이트웨이 제한을 보고합니다. 셋째, 실제로 제공되는 모델, 캐시 상태 및 장애 조치 발생 여부를 전달하는 모든 응답에 대해 추가 amplink 블록을 반환합니다.

우리는 필드의 의미를 조용히 바꾸는 일은 하지 않습니다. 확장은 들어오는 길에 extra_body로 들어가고 나가는 길에 네임스페이스 블록으로 들어갑니다.

지원되지 않는 매개변수는 무시되는 대신 400를 사용하여 거부됩니다. logit_bias를 조용히 삭제하면 일주일 동안 품질 회귀를 디버깅하게 됩니다.

엔지니어링의 다른 글

Gemini 4 Argon API 연동 가이드

2026년 10월 15일 · 읽는 시간 19분

Jev 해설: 프로덕션을 위한 안정적이고 타입이 지정된 AI 의사결정 구축 방법

2026년 10월 10일 · 읽는 시간 20분

LLM API란? 개발자를 위한 실전 가이드

2026년 9월 16일 · 읽는 시간 11분