Kompatibilitas OpenAI SDK (beta)

​

Sebelum Anda memulai

Lapisan kompatibilitas ini ditujukan untuk menguji dan membandingkan kemampuan model dengan upaya pengembangan minimal dan tidak dianggap sebagai solusi jangka panjang atau siap produksi untuk sebagian besar kasus penggunaan. Untuk pengalaman terbaik dan akses ke rangkaian fitur lengkap Anthropic API (pemrosesan PDF, kutipan, pemikiran diperpanjang, dan caching prompt), kami merekomendasikan penggunaan Anthropic API asli.

​

Memulai dengan OpenAI SDK

Untuk menggunakan fitur kompatibilitas OpenAI SDK, Anda perlu:

1. Menggunakan OpenAI SDK resmi
2. Mengubah hal-hal berikut
   • Perbarui URL dasar Anda untuk mengarah ke API Anthropic
   • Ganti kunci API Anda dengan kunci API Anthropic
   • Perbarui nama model Anda untuk menggunakan model Claude
3. Tinjau dokumentasi di bawah ini untuk fitur-fitur yang didukung

​

Contoh mulai cepat

from openai import OpenAI

client = OpenAI(
    api_key="ANTHROPIC_API_KEY",  # Kunci API Anthropic Anda
    base_url="https://api.anthropic.com/v1/"  # Endpoint API Anthropic
)

response = client.chat.completions.create(
    model="claude-opus-4-20250514", # Nama model Anthropic
    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 dari penggunaan OpenAI:

• Parameter strict untuk pemanggilan fungsi diabaikan, yang berarti JSON penggunaan alat tidak dijamin mengikuti skema yang disediakan.
• Input audio tidak didukung; input tersebut akan diabaikan dan dihapus dari input
• Caching prompt tidak didukung, tetapi didukung di Anthropic SDK
• Pesan sistem/pengembang dipindahkan dan digabungkan ke awal percakapan, karena Anthropic hanya mendukung satu pesan sistem awal.

Sebagian besar bidang yang tidak didukung diabaikan secara diam-diam daripada menghasilkan kesalahan. Semua ini didokumentasikan di bawah.

​

Pertimbangan kualitas output

Jika Anda telah melakukan banyak penyesuaian pada prompt Anda, kemungkinan prompt tersebut telah disesuaikan dengan baik khusus untuk OpenAI. Pertimbangkan untuk menggunakan penyempurna prompt di Anthropic Console sebagai titik awal yang baik.

​

Pengangkatan pesan sistem / pengembang

Sebagian besar input ke OpenAI SDK jelas memetakan langsung ke parameter API Anthropic, tetapi satu perbedaan yang berbeda adalah penanganan prompt sistem / pengembang. Kedua prompt ini dapat ditempatkan di seluruh percakapan chat melalui OpenAI. Karena Anthropic hanya mendukung pesan sistem awal, kami mengambil semua pesan sistem/pengembang dan menggabungkannya bersama dengan satu baris baru (\n) di antara mereka. 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 akan meningkatkan penalaran Claude untuk tugas-tugas kompleks, OpenAI SDK tidak akan mengembalikan proses pemikiran terperinci Claude. Untuk fitur pemikiran diperpanjang penuh, termasuk akses ke output penalaran langkah demi langkah Claude, gunakan API Anthropic asli.

response = client.chat.completions.create(
    model="claude-opus-4-20250514",
    messages=...,
    extra_body={
        "thinking": { "type": "enabled", "budget_tokens": 2000 }
    }
)

​

Batas rate

Batas rate mengikuti batas standar Anthropic untuk endpoint /v1/messages.

​

Dukungan API Kompatibel OpenAI Terperinci

​

Bidang permintaan

​

Bidang sederhana

​

Bidang tools / functions

​

Bidang array messages

​

Bidang respons

​

Kompatibilitas pesan kesalahan

Lapisan kompatibilitas mempertahankan format kesalahan yang konsisten dengan API OpenAI. Namun, pesan kesalahan terperinci tidak akan setara. Kami merekomendasikan hanya menggunakan pesan kesalahan untuk pencatatan dan debugging.

​

Kompatibilitas header

Meskipun OpenAI SDK secara otomatis mengelola header, berikut adalah daftar lengkap header yang didukung oleh API Anthropic untuk pengembang yang perlu bekerja dengan header secara langsung.