OpenAI SDK互換性

OpenAI SDKの使用を開始する

OpenAI SDK互換機能を使用するには、以下が必要です。

1. 公式のOpenAI SDKを使用する
2. 以下を変更する
   • ベースURLをClaude APIを指すように更新する
   • APIキーをClaude APIキーに置き換える
   • モデル名をClaudeモデルを使用するように更新する
3. サポートされている機能について、以下のドキュメントを確認する

クイックスタートの例

OpenAI互換性に関する重要な制限事項

APIの動作

OpenAIを使用する場合との最も重要な違いは以下のとおりです。

• 関数呼び出しのstrictパラメータは無視されるため、ツール使用のJSONが指定されたスキーマに従うことは保証されません。スキーマへの準拠を保証するには、ネイティブのClaude APIと構造化出力を使用してください。
• 音声入力はサポートされていません。単に無視され、入力から削除されます
• プロンプトキャッシングはサポートされていませんが、Anthropic SDKではサポートされています
• システム/デベロッパーメッセージは会話の先頭に引き上げられて連結されます。これは、Anthropicが単一の初期システムメッセージのみをサポートしているためです。

サポートされていないフィールドのほとんどは、エラーを生成するのではなく、暗黙的に無視されます。これらはすべて以下に記載されています。

出力品質に関する考慮事項

プロンプトを多く調整してきた場合、それはOpenAI向けに最適化されている可能性が高いです。良い出発点として、Claude Consoleのプロンプト改善ツールの使用を検討してください。

システム/デベロッパーメッセージの引き上げ

OpenAI SDKへの入力のほとんどは、AnthropicのAPIパラメータに明確に直接対応しますが、1つの明確な違いはシステム/デベロッパープロンプトの処理です。OpenAIでは、これら2つのプロンプトをチャット会話全体に配置できます。Anthropicは初期システムメッセージのみをサポートしているため、APIはすべてのシステム/デベロッパーメッセージを取得し、それらの間に単一の改行（\n）を挟んで連結します。この完全な文字列が、メッセージの先頭で単一のシステムメッセージとして提供されます。

拡張思考のサポート

thinkingパラメータを追加することで、拡張思考機能を有効にできます。これにより複雑なタスクに対するClaudeの推論が向上しますが、OpenAI SDKはClaudeの詳細な思考プロセスを返しません。Claudeの段階的な推論出力へのアクセスを含む完全な拡張思考機能を利用するには、ネイティブのClaude APIを使用してください。

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Who are you?"}],
    extra_body={"thinking": {"type": "enabled", "budget_tokens": 2000}},
)

レート制限

レート制限は、/v1/messagesエンドポイントに対するAnthropicの標準制限に従います。

OpenAI互換APIサポートの詳細

リクエストフィールド

シンプルなフィールド

tools / functionsフィールド

messages配列フィールド

レスポンスフィールド

エラーメッセージの互換性

互換レイヤーは、OpenAI APIと一貫したエラー形式を維持します。ただし、詳細なエラーメッセージは同等ではありません。エラーメッセージはログ記録とデバッグにのみ使用してください。

ヘッダーの互換性

OpenAI SDKはヘッダーを自動的に管理しますが、ヘッダーを直接操作する必要がある開発者向けに、Claude APIがサポートするヘッダーの完全なリストを以下に示します。