Menyelesaikan Masalah API Model Claude Opus 4.6 Thinking: Analisis Lengkap Kompatibilitas Format antara /v1/messages dan /v1/chat/completions

Catatan Penulis: Analisis mendalam tentang penyebab mendasar kesalahan "content should be a valid list" saat memanggil model Claude Opus 4.6 Thinking melalui layanan proksi API, serta perbedaan format dan solusi kompatibilitas antara dua endpoint /v1/messages dan /v1/chat/completions.

Pernahkah kamu mengalami skenario ini: menggunakan model claude-opus-4-6-thinking melalui /v1/chat/completions (format OpenAI) berjalan normal, tapi saat beralih ke /v1/messages (format native Anthropic) malah muncul error content: Input should be a valid list? Fenomena yang tampak kontra-intuitif ini sebenarnya mengungkap masalah kompatibilitas mendalam antara dua format API untuk model Thinking. Artikel ini akan membahas dari dasar format API, menjelaskan secara tuntas penyebab error dan cara pemanggilan yang benar.

Nilai Inti: Setelah membaca artikel ini, kamu akan memahami perbedaan perilaku model Thinking dalam dua format API, menyelesaikan error content should be a valid list, dan menguasai cara menangani thinking blocks dalam percakapan multi-putaran dengan benar.

Poin Inti Kompatibilitas API Model Claude Thinking

Mari kita jawab langsung inti dari fenomena "kontra-intuitif" ini.

Inti Teknis Error API Model Claude Thinking

Pesan error content: Input should be a valid list ini mengungkap perbedaan format yang krusial:

API Asli Anthropic (/v1/messages) mengharuskan field content berupa array blok konten (list):

{
  "role": "assistant",
  "content": [
    {"type": "thinking", "thinking": "Mari saya analisis masalah ini...", "signature": "CpcH..."},
    {"type": "text", "text": "Ini adalah jawaban saya..."}
  ]
}

Format Kompatibel OpenAI (/v1/chat/completions) mengizinkan content sebagai string biasa:

{
  "role": "assistant",
  "content": "Ini adalah jawaban saya..."
}

Ketika platform proksi API (seperti backend APIYI) mengonfigurasi channel ke format /v1/messages, jika klien upstream mengirim content string dalam format OpenAI, proksi perlu mengonversi "string" menjadi [{"type": "text", "text": "string"}]. Jika konversi ini tidak lengkap—terutama untuk respons dari Model Thinking yang dikembalikan ke percakapan berikutnya—maka akan memicu error Input should be a valid list.

Perbandingan Detail Dua Format Endpoint API Model Claude Thinking

Ini adalah kunci untuk memahami masalah ini: kedua endpoint memiliki persyaratan yang berbeda secara fundamental untuk field content.

Perbedaan Format API Model Claude Thinking

Perbandingan Format Permintaan API Model Claude Thinking

Pemanggilan Format OpenAI (Direkomendasikan untuk skenario proksi):

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://vip.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="claude-opus-4-6-thinking",  # Alias platform proksi
    messages=[
        {"role": "user", "content": "Analisis prospek bisnis komputasi kuantum"}
    ],
    max_tokens=16000
)
print(response.choices[0].message.content)

import anthropic

client = anthropic.Anthropic(api_key="YOUR_API_KEY")

response = client.messages.create(
    model="claude-opus-4-6",  # Nama model resmi, tanpa -thinking
    max_tokens=16000,
    thinking={
        "type": "adaptive"    # Aktifkan thinking melalui parameter
    },
    messages=[
        {"role": "user", "content": "Analisis prospek bisnis komputasi kuantum"}
    ]
)

# Respons content adalah daftar, berisi blok thinking dan text
for block in response.content:
    if block.type == "thinking":
        print(f"[Proses Berpikir] {block.thinking[:100]}...")
    elif block.type == "text":
        print(f"[Jawaban] {block.text}")

🎯 Saran Pemanggilan: Jika Anda memanggil Model Claude Thinking melalui platform proksi, prioritaskan penggunaan /v1/chat/completions (format OpenAI), kompatibilitasnya terbaik.
Endpoint kompatibel OpenAI dari platform APIYI apiyi.com telah diadaptasi untuk Model Thinking, menangani konversi thinking blocks secara otomatis.

Mengapa Format OpenAI Justru Berjalan Lebih Lancar untuk API Model Claude Thinking

Ini adalah bagian yang paling kontra-intuitif: menggunakan format "non-asli" OpenAI untuk memanggil model Claude Thinking justru memberikan kompatibilitas yang lebih baik. Ada tiga alasan:

Alasan 1: Tingkat Kelonggaran Format content Berbeda

Format OpenAI mengizinkan content berupa string murni "hello", maupun array blok konten [{"type":"text","text":"hello"}]. Format asli Anthropic hanya menerima array blok konten, format string langsung menyebabkan error.

Ketika kode klien mengirimkan content dalam bentuk string (ini adalah perilaku default OpenAI SDK), jika lalu lintas melewati saluran format OpenAI, format klien dan endpoint upstream konsisten, tidak ada masalah konversi. Namun jika melewati saluran format Anthropic, string tidak akan diterima.

Alasan 2: Pelepasan Otomatis Thinking Blocks

Mode kompatibel OpenAI secara otomatis akan melepaskan thinking blocks dari respons Claude, hanya mengembalikan teks akhir. Ini berarti:

• Klien tidak akan menerima thinking blocks
• Tidak perlu mengirimkan kembali thinking blocks pada percakapan berikutnya
• Tidak ada masalah pengurutan thinking blocks

Format asli Anthropic mengharuskan thinking blocks disimpan lengkap dalam percakapan multi-putaran, dan pesan asisten harus diawali dengan thinking block. Jika layanan proksi tidak menangani persyaratan pengurutan ini dengan benar, akan terjadi error.

Alasan 3: Masalah Pengiriman thoughtSignature

Seperti yang dijelaskan sebelumnya, thinking blocks dalam format Anthropic berisi tanda tangan terenkripsi (signature), yang harus dikirimkan kembali persis seperti aslinya. Format OpenAI langsung melewati bagian ini — tidak mengembalikan tanda tangan, dan juga tidak perlu mengirimkan kembali tanda tangan.

🎯 Saran Pemilihan: Saat memanggil model Claude Thinking melalui layanan proksi API, prioritaskan format /v1/chat/completions, hindari masalah kompatibilitas format thinking blocks.
Endpoint kompatibel OpenAI dari APIYI apiyi.com telah melakukan adaptasi lengkap untuk model Thinking.

Perbandingan Skema Pemanggilan API Model Claude Thinking

Tiga Skema Pemanggilan API Model Claude Thinking

Perbedaan Nama Model API Claude Thinking

Platform yang berbeda memiliki cara penamaan model Thinking yang berbeda, ini juga merupakan titik kebingungan yang umum:

Di API resmi Anthropic, tidak ada nama model claude-opus-4-6-thinking. Sufiks -thinking adalah konvensi penamaan platform proksi, yang memungkinkan pengguna mengaktifkan fungsi thinking langsung melalui nama model, tanpa perlu mengatur parameter secara manual.

Petunjuk: Jika Anda menggunakan nama model claude-opus-4-6-thinking di APIYI apiyi.com, platform akan secara otomatis menambahkan parameter thinking: {"type": "adaptive"} ke dalam permintaan. Dengan demikian, Anda bisa langsung mendapatkan kemampuan thinking menggunakan OpenAI SDK, tanpa perlu mengubah kode.

Masalah Umum dan Solusi API Model Claude Thinking

Pertanyaan Umum

Ringkasan

Inti masalah kompatibilitas API model Claude Thinking:

1. Penyebab error adalah format content yang tidak cocok: API asli Anthropic mengharuskan content berupa daftar (list), sedangkan format OpenAI mengizinkan string—jika saluran proksi menggunakan /v1/messages tetapi klien mengirim string, akan muncul error Input should be a valid list
2. Format OpenAI lebih kompatibel: Secara otomatis menghapus thinking blocks, tidak perlu mengirimkan signature, content bisa berupa string—pilihan utama untuk skenario proksi
3. Akhiran -thinking adalah konvensi proksi, bukan nama model resmi: Nama model resmi adalah claude-opus-4-6, thinking diaktifkan melalui parameter

Untuk memanggil model Claude Thinking melalui proksi API, solusi termudah adalah menggunakan format kompatibel OpenAI secara konsisten.

Direkomendasikan untuk memanggil melalui APIYI apiyi.com, platform telah mengoptimalkan kompatibilitas format untuk model Thinking, menyediakan kuota gratis dan antarmuka terpadu untuk berbagai model.

📚 Referensi

1. Dokumentasi Claude API Extended Thinking: Referensi API lengkap untuk mode berpikir

   • Tautan: platform.claude.com/docs/en/build-with-claude/extended-thinking
   • Penjelasan: Berisi penjelasan detail tentang adaptive thinking, parameter effort, format blok konten

2. Dokumentasi Kompatibilitas Claude API OpenAI SDK: Panduan resmi memanggil Claude dengan format OpenAI

   • Tautan: platform.claude.com/docs/en/api/openai-sdk
   • Penjelasan: Berisi batasan kompatibilitas dan daftar fitur yang tidak didukung

3. Referensi Kode Error Claude API: Penjelasan semua jenis error API

   • Tautan: platform.claude.com/docs/en/api/errors
   • Penjelasan: Berisi metode pemecahan masalah spesifik untuk invalid_request_error

4. Pusat Dokumentasi APIYI: Memanggil model Claude Thinking melalui antarmuka kompatibel OpenAI

   • Tautan: docs.apiyi.com
   • Penjelasan: Telah menyesuaikan format untuk model Thinking, secara otomatis menangani konversi thinking blocks

Penulis: Tim Teknis APIYI
Diskusi Teknis: Selamat berdiskusi di kolom komentar, materi lebih lanjut dapat diakses di pusat dokumentasi APIYI docs.apiyi.com