OpenAI SDK 호환성 (베타)

​

시작하기 전에

이 호환성 레이어는 최소한의 개발 노력으로 모델 기능을 테스트하고 비교하기 위한 것이며, 대부분의 사용 사례에서 장기적이거나 프로덕션 준비가 된 솔루션으로 간주되지 않습니다. Anthropic API의 전체 기능 세트(PDF 처리, 인용, 확장된 사고, 프롬프트 캐싱)를 최대한 활용하기 위해서는 네이티브 Anthropic API를 사용하는 것을 권장합니다.

​

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-3-7-sonnet-20250219", # 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-3-7-sonnet-20250219",
    messages=...,
    extra_body={
        "thinking": { "type": "enabled", "budget_tokens": 2000 }
    }
)

​

속도 제한

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

​

상세 OpenAI 호환 API 지원

​

요청 필드

​

단순 필드

​

tools / functions 필드

​

messages 배열 필드

​

응답 필드

​

오류 메시지 호환성

호환성 레이어는 OpenAI API와 일관된 오류 형식을 유지합니다. 하지만 상세한 오류 메시지는 동일하지 않을 것입니다. 오류 메시지는 로깅과 디버깅용으로만 사용하는 것을 권장합니다.

​

헤더 호환성

OpenAI SDK가 자동으로 헤더를 관리하지만, 직접 헤더를 다뤄야 하는 개발자를 위해 Anthropic의 API가 지원하는 전체 헤더 목록입니다.