Kompatibilitas OpenAI SDK



Memulai dengan OpenAI SDK

Untuk menggunakan fitur kompatibilitas OpenAI SDK, Anda perlu:

1. Menggunakan OpenAI SDK resmi
2. Mengubah hal-hal berikut
   • Perbarui base URL Anda agar mengarah ke Claude API
   • Ganti kunci API Anda dengan kunci Claude API
   • Perbarui nama model Anda untuk menggunakan model Claude
3. Tinjau bagian-bagian berikut untuk mengetahui fitur apa saja yang didukung



Contoh memulai cepat

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("ANTHROPIC_API_KEY"),  # Your Claude API key
    base_url="https://api.anthropic.com/v1/",  # the Claude API endpoint
)

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

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



Keterbatasan penting kompatibilitas OpenAI



Perilaku API

Berikut adalah perbedaan paling substansial dibandingkan menggunakan OpenAI:

• Parameter strict untuk pemanggilan fungsi diabaikan, yang berarti JSON tool_use tidak dijamin mengikuti skema yang diberikan. Untuk jaminan kesesuaian skema, gunakan Claude API native dengan Structured Outputs.
• Input audio tidak didukung; input tersebut akan diabaikan dan dihapus dari input
• Caching prompt tidak didukung, tetapi didukung di Anthropic SDK
• Pesan system/developer diangkat dan digabungkan ke awal percakapan, karena Anthropic hanya mendukung satu pesan sistem awal.

Sebagian besar field yang tidak didukung diabaikan secara diam-diam alih-alih menghasilkan error. Semuanya didokumentasikan di bagian-bagian berikut.



Pertimbangan kualitas output

Jika Anda telah melakukan banyak penyesuaian pada prompt Anda, kemungkinan besar prompt tersebut telah disetel dengan baik khusus untuk OpenAI. Pertimbangkan untuk mengerjakannya ulang untuk Claude menggunakan panduan praktik terbaik prompting.



Pengangkatan pesan system / developer

Sebagian besar input ke OpenAI SDK jelas dipetakan langsung ke parameter API Anthropic, tetapi satu perbedaan yang mencolok adalah penanganan prompt system / developer. Kedua prompt ini dapat ditempatkan di sepanjang percakapan chat melalui OpenAI. Karena Anthropic hanya mendukung pesan sistem awal, API mengambil semua pesan system/developer dan menggabungkannya bersama dengan satu baris baru (\n) di antaranya. String lengkap ini kemudian diberikan sebagai satu pesan sistem di awal pesan.



Dukungan pemikiran

Anda dapat mengaktifkan pemikiran dengan menambahkan parameter thinking. Pada model saat ini, pemikiran bersifat adaptif, dengan Claude yang memutuskan kapan dan seberapa dalam untuk berpikir, dan pada model Claude 5 fitur ini aktif secara default; pemikiran diperpanjang yang dikonfigurasi secara manual adalah mode lama. Meskipun pemikiran meningkatkan penalaran Claude untuk tugas-tugas kompleks, OpenAI SDK tidak mengembalikan proses berpikir Claude secara terperinci. Untuk fitur pemikiran lengkap, termasuk akses ke output penalaran langkah demi langkah Claude, gunakan Claude API native.

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}},
)



Batas laju

"Rate limit" (batas laju) mengikuti batas standar Anthropic untuk endpoint /v1/messages.



Dukungan API kompatibel OpenAI secara terperinci



Field permintaan



Field sederhana



Field tools / functions



Field array messages



Field respons



Kompatibilitas pesan error

Lapisan kompatibilitas mempertahankan format error yang konsisten dengan OpenAI API. Namun, pesan error yang terperinci tidak akan setara. Gunakan pesan error hanya untuk logging dan debugging.



Kompatibilitas header

Meskipun OpenAI SDK secara otomatis mengelola header, berikut adalah daftar lengkap header yang didukung oleh Claude API bagi pengembang yang perlu bekerja dengannya secara langsung.