OpenAI SDK 호환성

​

OpenAI SDK 시작하기

OpenAI SDK 호환성 기능을 사용하려면 다음이 필요합니다:

1. 공식 OpenAI SDK 사용
2. 다음 사항 변경
   • 기본 URL을 Anthropic의 API로 가리키도록 업데이트
   • API 키를 Anthropic API 키로 교체
   • 모델 이름을 Claude 모델을 사용하도록 업데이트
3. 지원되는 기능에 대한 아래 문서 검토

​

빠른 시작 예제

from openai import OpenAI

client = OpenAI(
    api_key="ANTHROPIC_API_KEY",  # Your Anthropic API key
    base_url="https://api.anthropic.com/v1/"  # Anthropic's API endpoint
)

response = client.chat.completions.create(
    model="claude-opus-4-20250514", # Anthropic model name
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"}
    ],
)

print(response.choices[0].message.content)

​

중요한 OpenAI 호환성 제한사항

​

API 동작

OpenAI 사용과의 가장 중요한 차이점은 다음과 같습니다:

• 함수 호출의 strict 매개변수는 무시되며, 이는 도구 사용 JSON이 제공된 스키마를 따르는 것이 보장되지 않음을 의미합니다.
• 오디오 입력은 지원되지 않으며, 단순히 무시되고 입력에서 제거됩니다
• 프롬프트 캐싱은 지원되지 않지만, Anthropic SDK에서는 지원됩니다
• 시스템/개발자 메시지는 대화 시작 부분으로 끌어올려지고 연결됩니다. Anthropic은 단일 초기 시스템 메시지만 지원하기 때문입니다.

지원되지 않는 대부분의 필드는 오류를 발생시키지 않고 조용히 무시됩니다. 이들은 모두 아래에 문서화되어 있습니다.

​

출력 품질 고려사항

프롬프트를 많이 조정했다면, OpenAI에 특별히 잘 맞춰져 있을 가능성이 높습니다. 좋은 시작점으로 Anthropic Console의 프롬프트 개선기를 사용하는 것을 고려해보세요.

​

시스템 / 개발자 메시지 끌어올리기

OpenAI SDK에 대한 대부분의 입력은 Anthropic의 API 매개변수에 직접 명확하게 매핑되지만, 한 가지 뚜렷한 차이점은 시스템/개발자 프롬프트의 처리입니다. 이 두 프롬프트는 OpenAI를 통해 채팅 대화 전체에 배치될 수 있습니다. Anthropic은 초기 시스템 메시지만 지원하므로, 모든 시스템/개발자 메시지를 가져와서 그들 사이에 단일 개행(\n)으로 연결합니다. 이 전체 문자열은 메시지 시작 부분에 단일 시스템 메시지로 제공됩니다.

​

확장된 사고 지원

thinking 매개변수를 추가하여 확장된 사고 기능을 활성화할 수 있습니다. 이는 복잡한 작업에 대한 Claude의 추론을 개선하지만, OpenAI SDK는 Claude의 상세한 사고 과정을 반환하지 않습니다. Claude의 단계별 추론 출력에 대한 액세스를 포함한 전체 확장된 사고 기능을 위해서는 네이티브 Anthropic API를 사용하세요.

response = client.chat.completions.create(
    model="claude-opus-4-20250514",
    messages=...,
    extra_body={
        "thinking": { "type": "enabled", "budget_tokens": 2000 }
    }
)

​

속도 제한

속도 제한은 /v1/messages 엔드포인트에 대한 Anthropic의 표준 제한을 따릅니다.

​

상세한 OpenAI 호환 API 지원

​

요청 필드

​

단순 필드

​

tools / functions 필드

​

messages 배열 필드

​

응답 필드

​

오류 메시지 호환성

호환성 레이어는 OpenAI API와 일관된 오류 형식을 유지합니다. 그러나 상세한 오류 메시지는 동일하지 않습니다. 로깅 및 디버깅을 위해서만 오류 메시지를 사용하는 것을 권장합니다.

​

헤더 호환성

OpenAI SDK는 헤더를 자동으로 관리하지만, 직접 작업해야 하는 개발자를 위해 Anthropic의 API에서 지원하는 헤더의 전체 목록은 다음과 같습니다.