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 dari Claude Console.
   • Jika kunci Anda adalah kunci akun pribadi atau akun layanan yang tidak dibatasi pada sebuah workspace, kirimkan juga header anthropic-workspace-id pada setiap permintaan (misalnya, default_headers di Python SDK atau defaultHeaders di TypeScript); lihat Memilih workspace.
   • Perbarui nama model Anda untuk menggunakan model Claude.
3. Tinjau bagian-bagian berikut untuk mengetahui fitur apa saja yang didukung.

Contoh mulai 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-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 function calling diabaikan, yang berarti JSON penggunaan alat tidak dijamin mengikuti skema yang diberikan. Untuk kesesuaian skema yang terjamin, gunakan Claude API native dengan structured outputs.
• Input audio tidak didukung; input tersebut diabaikan dan dihapus dari input.
• Caching prompt tidak didukung, tetapi didukung di Anthropic SDK.
• Pesan system/developer diangkat (hoisted) dan digabungkan ke dalam field system tingkat atas, di mana pun pesan tersebut muncul dalam percakapan. Untuk menambahkan instruksi sistem di tengah percakapan, gunakan pesan sistem di tengah percakapan di Claude API native.

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 menyesuaikan prompt Anda secara ekstensif, kemungkinan besar prompt tersebut disetel khusus untuk OpenAI. Pertimbangkan untuk menyusunnya ulang untuk Claude menggunakan panduan praktik terbaik prompting.

Pengangkatan pesan system / developer

Sebagian besar input ke OpenAI SDK dipetakan secara jelas dan langsung ke parameter Claude API, tetapi satu perbedaan yang mencolok adalah penanganan prompt system / developer. Kedua prompt ini dapat ditempatkan di sepanjang percakapan chat di OpenAI API. Lapisan kompatibilitas mengambil semua pesan system/developer dan menggabungkannya dengan satu baris baru (\n) di antaranya. String lengkap ini kemudian diberikan sebagai field system tingkat atas, sebelum setiap pesan.

Dukungan thinking

Anda dapat mengaktifkan thinking dengan menambahkan parameter thinking. Pada model saat ini, thinking bersifat adaptif, dengan Claude menentukan kapan dan seberapa dalam untuk berpikir, dan pada model Claude 5 fitur ini aktif secara default; "extended thinking" (pemikiran diperpanjang) yang dikonfigurasi secara manual adalah mode lama (legacy). Meskipun thinking meningkatkan penalaran Claude untuk tugas-tugas kompleks, OpenAI SDK tidak mengembalikan thinking Claude. Untuk fitur thinking lengkap, termasuk thinking yang diringkas, 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 detail tidak 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 untuk developer yang perlu bekerja dengan header tersebut secara langsung.