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 dokumentasi di bawah ini 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-4-8",  # Claude model name
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"},
    ],
)

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

Batasan penting kompatibilitas OpenAI

Perilaku API

Berikut adalah perbedaan paling substansial dibandingkan dengan menggunakan OpenAI:

• Parameter strict untuk pemanggilan fungsi diabaikan, yang berarti JSON penggunaan alat tidak dijamin mengikuti skema yang disediakan. Untuk kesesuaian skema yang terjamin, gunakan Claude API native dengan Structured Outputs.
• Input audio tidak didukung; input tersebut akan diabaikan begitu saja 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 bawah ini.

Pertimbangan kualitas output

Jika Anda telah melakukan banyak penyesuaian pada prompt Anda, kemungkinan besar prompt tersebut sudah disetel dengan baik khusus untuk OpenAI. Pertimbangkan untuk menggunakan prompt improver di Claude Console sebagai titik awal yang baik.

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 satu pesan sistem awal, API mengambil semua pesan system/developer dan menggabungkannya bersama dengan satu newline (\n) di antaranya. String lengkap ini kemudian disediakan sebagai satu pesan sistem di awal pesan.

Dukungan pemikiran diperpanjang

Anda dapat mengaktifkan kemampuan pemikiran diperpanjang dengan menambahkan parameter thinking. Meskipun ini meningkatkan penalaran Claude untuk tugas-tugas kompleks, OpenAI SDK tidak mengembalikan proses pemikiran terperinci Claude. Untuk fitur pemikiran diperpanjang 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

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 terperinci tidak akan setara. Hanya gunakan pesan error 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 dengannya secara langsung.