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",  # Anthropic API 키
    base_url="https://api.anthropic.com/v1/"  # Anthropic API 엔드포인트
)

response = client.chat.completions.create(
    model="claude-opus-4-20250514", # Anthropic 모델 이름
    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에서 지원하는 헤더의 전체 목록은 다음과 같습니다.