Panggil model melalui API Messages yang kompatibel dengan format Anthropic, serta lihat deskripsi parameter input dan output beserta contoh pemanggilan.
api_key: Ganti dengan Kunci API Model Studio.base_url: Ganti dengan alamat titik akhir kompatibel Model Studio (lihat informasi akses di bawah).model: Ganti dengan nama model yang didukung Model Studio (misalnya,qwen3.7-plus).
- Singapura
- China (Beijing)
- AS (Virginia)
- Jerman (Frankfurt)
- Jepang (Tokyo)
base_url untuk panggilan SDK: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropicURL permintaan HTTP: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic/v1/messages{WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.
Otentikasi: masukkan Kunci API Model Studio Anda melalui header permintaan x-api-key atau header permintaan Authorization: Bearer. Salah satu saja sudah cukup.
Perbedaan utama dari API Anthropic resmi
Perbedaan berikut dirangkum dari dokumen ini. Perhatikan dengan saksama saat bermigrasi dari API Anthropic resmi:
Perbedaan | Deskripsi |
Titik akhir (Base URL) |
|
Metode otentikasi |
|
Model |
|
Rentang nilai temperature | Model Studio menggunakan rentang [0, 2), yang berbeda dari rentang resmi Anthropic [0.0, 1.0]; verifikasi nilai parameter ini saat bermigrasi. |
Cakupan API | Hanya API Messages ( |
Parameter ekstensi |
|
Isi Permintaanmodelstring (Wajib)Nama model. Model yang didukung adalah sebagai berikut.
Daftar model yang didukung Qwen Max: qwen4-max, seri qwen3.8-max, qwen3.7-max, qwen3.7-max-2026-05-20, qwen3.7-max-2026-06-08Qwen Plus: qwen3.7-plus, qwen3.7-plus-2026-05-26, qwen3.6-plus, qwen3.6-plus-2026-04-02, qwen3.5-plus, qwen3.5-plus-2026-04-20, qwen3.5-plus-2026-02-15, qwen-plus, qwen-plus-latestQwen Flash: qwen3.8-flash, qwen3.7-flash, qwen3.7-flash-2026-07-15, qwen3.6-flash, qwen3.6-flash-2026-04-16, qwen3.5-flash, qwen3.5-flash-2026-02-23, qwen-flash, qwen-flash-2025-07-28Qwen Coder: qwen3-coder-flashQwen VL: qwen3-vl-plusModel open-source Qwen: qwen3.6-27b, qwen3.5-397b-a17b, qwen3.5-122b-a10b, qwen3.5-27b, qwen3.5-35b-a3b, qwen3.8-2.4t-a95b, qwen3.8-27bModel pihak ketigadeepseek-v4.1-flash, deepseek-v4-pro, deepseek-v4-pro-0813, deepseek-v4-flash-0731, kimi-k3.1-pro, kimi-k3, kimi-k2.7-code, kimi-k2.6, kimi-k2.5, glm-5.3, glm-5.2, glm-5.1, glm-5, MiniMax-M2.5, deepseek-v4.1-flash-1017 integer (Wajib)
string atau array (Opsional)Prompt sistem, digunakan untuk menentukan peran atau perilaku model.Meneruskan string setara dengan satu blok konten type="text". Saat Anda perlu menandai titik pemutusan cache eksplisit untuk prompt sistem (lihat contoh "Cache Eksplisit" di sebelah kanan), Anda harus meneruskan array.
Properti type string (Wajib)Nilai tetap: text.text string (Wajib)Teks prompt sistem.cache_control object (Opsional)Menandai titik pemutusan cache eksplisit pada blok konten ini (lihat contoh "Cache Eksplisit" di sebelah kanan). Setelah terjadi cache hit, permintaan kedua dan seterusnya ditagih sebagai pembacaan cache. Hanya berisi bidang type, yang nilainya tetap ephemeral.
Properti (Qwen4) Hanya qwen4-max yang didukung. Penanda cache blok konten untuk Qwen4 juga mendukung ttl, dengan nilai opsional 5m dan 1h, secara default 5m. Untuk informasi lebih lanjut, lihat Cache Eksplisit (Qwen4).type string (Wajib)ephemeralttl string (Opsional)Masa berlaku cache. Mendukung 5m dan 1h, secara default 5m.array (Wajib)
Elemen array messages role string (Wajib)Peran pesan. Nilai valid: user, assistant, dan system.content string atau array (Wajib)Konten pesan. Dapat berupa string teks biasa atau array konten terstruktur. Saat content berupa string, hal itu setara dengan satu blok konten type="text".
Jenis elemen array content
thinking (qwen4-max) type stringthinkingthinking stringsignature stringRingkasan berpikir dan teks sandi tanda tangan. Teruskan kembali blok thinking lengkap apa adanya dalam permintaan berikutnya.
Properti type string (Wajib)Nilai tetap: text.text string (Wajib)Konten teks.cache_control object (Opsional)Menandai titik pemutusan cache eksplisit pada blok teks ini (lihat contoh "Cache Eksplisit" di sebelah kanan). Hanya berisi bidang type, yang nilainya tetap ephemeral.
Properti (Qwen4) Hanya qwen4-max yang didukung. Penanda cache blok konten untuk Qwen4 juga mendukung ttl, dengan nilai opsional 5m dan 1h, secara default 5m. Untuk informasi lebih lanjut, lihat Cache Eksplisit (Qwen4).type string (Wajib)ephemeralttl string (Opsional)Masa berlaku cache. Mendukung 5m dan 1h, secara default 5m.
Properti type string (Wajib)Nilai tetap: image.source object (Wajib)Sumber data gambar.
Properti type string (Wajib)Nilai valid: url (URL gambar publik) dan base64 (pengodean Base64).url stringURL publik gambar. Wajib jika type bernilai url.media_type stringTipe MIME gambar, seperti image/jpeg. Wajib jika type bernilai base64.data stringData gambar yang dikodekan Base64. Wajib jika type bernilai base64.
Properti type string (Wajib)Nilai tetap: video.source object (Wajib)Sumber data video.
Properti type string (Wajib)Nilai valid: url (URL video publik) dan base64 (pengodean Base64).url stringURL publik video. Wajib jika type bernilai url.media_type stringTipe MIME video, seperti video/mp4. Wajib jika type bernilai base64.data stringData video yang dikodekan Base64. Wajib jika type bernilai base64.
Properti type string (Wajib)Nilai tetap: document.source object (Wajib)Sumber data dokumen PDF, yang berisi bidang-bidang berikut:
Properti type string (Wajib)Nilai tetap: tool_use.id string (Wajib)Identifier unik pemanggilan tool, digunakan untuk mengaitkan hasil dalam tool_result berikutnya.name string (Wajib)Nama tool yang dipanggil.input object (Wajib)Parameter input pemanggilan tool, yang strukturnya ditentukan oleh input_schema dari tool terkait dalam tools.cache_control object (Opsional)Menandai titik pemutusan cache eksplisit pada blok ini (lihat contoh "Cache Eksplisit" di sebelah kanan). Hanya berisi bidang type, tetap ephemeral. Konten pemanggilan tool itu sendiri termasuk dalam prefiks cache.
Properti (Qwen4) Hanya qwen4-max yang didukung. Penanda cache blok konten untuk Qwen4 juga mendukung ttl, dengan nilai opsional 5m dan 1h, secara default 5m. Untuk informasi lebih lanjut, lihat Cache Eksplisit (Qwen4).type string (Wajib)ephemeralttl string (Opsional)Masa berlaku cache. Mendukung 5m dan 1h, secara default 5m.
Properti type string (Wajib)Nilai tetap: tool_result.tool_use_id string (Wajib)Bersesuaian dengan id dalam informasi tool_use.content string (Wajib)Konten yang dikembalikan oleh eksekusi tool.cache_control object (Opsional)Menandai titik pemutusan cache eksplisit pada blok hasil tool ini (lihat contoh "Cache Eksplisit" di sebelah kanan). Hanya berisi bidang type, tetap ephemeral.
Properti (Qwen4) Hanya qwen4-max yang didukung. Penanda cache blok konten untuk Qwen4 juga mendukung ttl, dengan nilai opsional 5m dan 1h, secara default 5m. Untuk informasi lebih lanjut, lihat Cache Eksplisit (Qwen4).type string (Wajib)ephemeralttl string (Opsional)Masa berlaku cache. Mendukung 5m dan 1h, secara default 5m.object (Opsional)Hanya didukung untuk qwen4-max. Mengaktifkan cache otomatis pada tingkat teratas permintaan, atau Anda dapat menetapkan titik pemutusan manual pada blok konten. type tetap ephemeral. Python SDK meneruskan parameter nonstandar tingkat teratas melalui extra_body; Node.js SDK dan curl meneruskannya secara langsung. Untuk informasi lebih lanjut, lihat Cache Eksplisit (Qwen4).
Properti type string (Wajib)ephemeralttl string (Opsional)Masa berlaku cache. Mendukung 5m dan 1h, secara default 5m.boolean (Opsional)Apakah akan mengaktifkan output streaming. Nilai default adalah false.temperature number (Opsional)Mengontrol keragaman teks yang dihasilkan. Rentang nilainya adalah [0, 2). Nilai yang lebih besar menghasilkan hasil generasi yang lebih acak.Rentang ini berbeda dari rentang resmi Anthropic yaitu [0.0, 1.0]. Jika Anda bermigrasi dari Anthropic, konfirmasi nilai parameter ini. number (Opsional)Ambang probabilitas untuk nucleus sampling, yang mengontrol keragaman teks yang dihasilkan.top_k integer (Opsional)Ukuran kumpulan kandidat pengambilan sampel selama generasi.stop_sequences array (Opsional)Urutan teks yang menghentikan generasi. Model berhenti menghasilkan konten sebelum urutan ini, dan urutan tersebut tidak disertakan dalam output.Saat terjadi pencocokan, stop_reason respons bernilai stop_sequence, dan urutan yang cocok dikembalikan dalam bidang stop_sequence respons.object (Opsional)Konfigurasi pemikiran mendalam. Saat diaktifkan, model melakukan penalaran sebelum menghasilkan balasan untuk meningkatkan akurasi jawaban. Saat diaktifkan, respons berisi blok konten bertipe thinking.Saat parameter ini tidak ditentukan, apakah akan berpikir ditentukan oleh perilaku default model: qwen4-max, seri qwen3.8-max, qwen3.8-flash, seri deepseek-v4, seri glm, dan kimi-k3.1-pro mengaktifkan pemikiran secara default; kimi-k2.6 dan kimi-k2.5 menonaktifkan pemikiran secara default; kimi-k2.7-code dan MiniMax-M2.5 hanya mendukung mode berpikir (tidak dapat dinonaktifkan). Untuk dukungan mode berpikir dan pengaturan default setiap model, lihat Pemikiran Mendalam.
Properti type string (Wajib)Nilai opsional: enabled (aktifkan mode berpikir) dan disabled (nonaktifkan mode berpikir).budget_tokens integer (Opsional, akan ditinggalkan)
Parameter ini akan segera ditinggalkan dan akan secara bertahap berhenti didukung pada model mendatang. Untuk integrasi baru, kami merekomendasikan menggunakan Jumlah token maksimum yang dapat digunakan oleh proses berpikir. Hubungannya dengan max_tokens bervariasi menurut model. Untuk informasi lebih lanjut, lihat deskripsi parameter max_tokens. Anggaran yang lebih besar menghasilkan analisis yang lebih menyeluruh atas masalah kompleks. Berlaku saat type bernilai enabled.display string (Opsional)qwen4-max: "summarized". Ringkasan dan enkripsi rantai-pikiran.Rantai-pikiran lengkap dikembalikan secara default. Setelah fitur ini diaktifkan, rantai-pikiran asli tidak lagi dikembalikan dalam teks biasa; sebagai gantinya, sebuah ringkasan dan teks sandi lengkap dikembalikan. Ringkasan digunakan untuk ditampilkan, dan teks sandi digunakan untuk memulihkan pemikiran historis.array (Opsional)Array definisi tool untuk skenario Function Call.
Elemen array tools name string (Wajib)Nama tool.description string (Opsional)Deskripsi fungsi tool.input_schema object (Wajib)Definisi JSON Schema dari parameter input tool.tools juga mendukung tool pencarian web sisi server Model Studio. Deklarasikan dalam tools untuk mengaktifkannya—tidak diperlukan pengambilan data di sisi klien.
Tool pencarian web type string (Wajib)Tipe tool, berupa nilai dengan akhiran tanggal seperti web_search_20250305. Akhiran tanggal tidak harus tetap; yang penting cocok dengan nilai yang dikirim oleh klien.name string (Wajib)Tetap web_search.max_uses integer (Opsional)Jumlah maksimum pengambilan data per permintaan.Saat memanggil langsung dengan Anthropic SDK atau HTTP, Anda wajib meneruskan identifier klien
Model berikut didukung: kimi-k3.1-pro (yang diterapkan di Alibaba Cloud Model Studio) mendukung web_search dan web_fetch di Beijing, Singapura, AS (Virginia), Jerman (Frankfurt), Jepang (Tokyo), dan Hong Kong, China.deepseek-v4.1-flash-1017 juga mendukung tool pengambilan web web_fetch. Untuk persyaratan dan contoh permintaan yang kompatibel dengan Anthropic, lihat web fetch.qwen4-max: web_search, web_fetch.Tambahkan tool web fetch sisi server Anthropic (dengan name diatur ke web_fetch) ke parameter tools untuk mengaktifkan web fetch, dan Anda juga harus menambahkan tool pencarian web (dengan name diatur ke web_search) pada saat yang sama. URL permintaannya adalah https://{WorkspaceId}.{region}.maas.aliyuncs.com/apps/anthropic.
web_fetch (qwen4-max) type string (Wajib)Tipe tool, berupa nilai dengan akhiran tanggal seperti web_fetch_20250910. Akhiran tanggal tidak harus tetap; yang penting cocok dengan nilai yang dikirim oleh klien.name string (Wajib)Tetap web_fetch.max_uses integerJumlah maksimum pengambilan data per permintaan.object (Opsional)Strategi pemilihan tool. Nilai berikut didukung:
object (Opsional)Pengaturan parameter output.
Properti effort string (Opsional)qwen4-maxNilai valid: low, high (default), dan xhigh.medium dipetakan ke high, dan max dipetakan ke xhigh.Mengontrol intensitas penalaran model.Nilai default kimi-k3.1-pro (yang diterapkan di Alibaba Cloud Model Studio) adalah max. Mendukung max (penalaran mendalam), high (penalaran yang ditingkatkan), medium (penalaran sedang), dan low (penalaran ringan).
object (Opsional)Konfigurasi output terstruktur. Saat diaktifkan, model akan menghasilkan string JSON. Model yang berbeda memberikan tingkat dukungan yang berbeda:
Properti type string (Wajib)Nilainya tetap json_schema.schema object (Wajib)Objek JSON Schema yang mengikuti spesifikasi JSON Schema standar. Harus mencakup bidang seperti type (tipe data), properties (definisi bidang), required (array nama bidang wajib), dan additionalProperties (harus diatur ke false).
Properti (Qwen4) Untuk informasi lebih lanjut, lihat Cache Eksplisit (Qwen4).input_tokens integerHanya menghitung token input yang tidak dibaca dari cache maupun digunakan untuk pembuatan cache; total input adalah penjumlahan bidang ini dengan jumlah token pembacaan cache dan pembuatan cache.output_tokens integerJumlah token output.cache_creation_input_tokens integerJumlah token input yang dikonsumsi untuk pembuatan cache.cache_read_input_tokens integerJumlah token input yang dikonsumsi untuk pembacaan cache.server_tool_use object (Opsional)Statistik penggunaan tool sisi server. Hanya dikembalikan saat tool sisi server (seperti pencarian web) digunakan dalam permintaan.
Properti web_search_requests integerJumlah pengambilan data pencarian web.web_fetch_requests integerJumlah perayapan halaman web.objectDetail pembuatan cache yang dijabarkan berdasarkan TTL. Penjumlahan jumlah token untuk kedua TTL sama dengan jumlah token yang digunakan untuk pembuatan cache ini.
Properti ephemeral_5m_input_tokens integerJumlah token yang digunakan untuk membuat cache 5 menit.ephemeral_1h_input_tokens integerJumlah token yang digunakan untuk membuat cache 1 jam.objectDetail pembacaan cache. cached_tokens sama dengan cache_read_input_tokens; jangan dihitung ganda dalam statistik penggunaan.
Properti cached_tokens integerJumlah token input yang dibaca dari cache. |
Python |
Respons Non-streamingidstringIdentifier unik pesan.type stringNilai tetap: message.role stringNilai tetap: assistant.model stringNama model yang digunakan.content arrayArray konten.
Jenis elemen array content Informasi Teks
Properti type stringNilai tetap: text.text stringTeks respons yang dihasilkan oleh model.
Properti type stringNilai tetap: thinking.thinking stringProses berpikir model sebelum menghasilkan respons akhir.signature stringqwen4-max, thinking.display="summarized": Blok thinking Anthropic Messages berisi ringkasan thinking dan teks sandi signature. Dalam mode streaming, thinking_delta dikembalikan terlebih dahulu, lalu signature_delta lengkap; setelah blok thinking ditutup, teks utama atau pemanggilan tool dikembalikan. Jika tidak ada pemikiran yang dihasilkan atau enkripsi gagal, signature dapat berupa string kosong.thinking.display != "summarized": Saat ini tetap berupa string kosong.
Properti type stringNilai tetap: tool_use.id stringIdentifier unik pemanggilan tool, digunakan untuk mengaitkan hasil dalam tool_result berikutnya.name stringNama tool yang dipanggil.input objectParameter input pemanggilan tool.
Properti type stringNilai tetap: server_tool_use.id stringIdentifier unik pemanggilan tool sisi server.name stringNama tool, seperti web_search.input objectParameter input, berisi array queries (kueri pengambilan data yang dihasilkan oleh model).caller object (Opsional)Informasi pemanggil; type bernilai direct menunjukkan bahwa panggilan dimulai langsung oleh model.
Properti type stringNilai tetap: web_search_tool_result.tool_use_id stringBersesuaian dengan id dalam server_tool_use.content arrayArray hasil pengambilan data, yang elemennya adalah objek web_search_result.
Properti web_search_result type stringNilai tetap: web_search_result.title stringJudul halaman.url stringURL halaman.encrypted_content stringKonten halaman terenkripsi.page_age string atau nullKesegaran halaman, dapat bernilai null.object (Opsional)Informasi pemanggil; type bernilai direct menunjukkan bahwa panggilan dimulai langsung oleh model.web_fetch_tool_result)
Hasil web fetch
stringAlasan penghentian. Nilai opsional: end_turn (penyelesaian normal), max_tokens (batas token tercapai), tool_use (pemanggilan tool).stop_sequence stringNilai tetap: null.usage objectStatistik penggunaan token.Dalam panggilan streaming, usage pada event message_start hanya berisi input_tokens dan output_tokens; bidang lengkap (termasuk cache_creation_input_tokens, cache_read_input_tokens, dan server_tool_use) dikembalikan dalam event message_delta.
Properti input_tokens integerJumlah token input.output_tokens integerJumlah token output.cache_creation_input_tokens integerJumlah token input yang dikonsumsi untuk pembuatan cache.cache_read_input_tokens integerJumlah token input yang dikonsumsi untuk pembacaan cache.server_tool_use object (Opsional)Statistik penggunaan tool sisi server. Hanya dikembalikan saat tool sisi server (seperti pencarian web) digunakan dalam permintaan.
Properti web_search_requests integerJumlah pengambilan data pencarian web.web_fetch_requests integerJumlah perayapan halaman web. |
Berikut adalah contoh respons qwen3.8-max, digunakan untuk mengilustrasikan bidang respons. |
Respons Streamingmessage_startEvent pertama dari stream, menandai awal pesan.
Properti type stringNilai tetap: message_start.message objectObjek pesan awal, dengan content berupa array kosong dan usage hanya berisi input_tokens dan output_tokens.
Properti type stringNilai tetap: content_block_start.index integerIndeks blok konten, dimulai dari 0, bersesuaian dengan posisi dalam array content pesan.content_block objectObjek awal blok konten. Nilai type adalah text, thinking, tool_use, server_tool_use, atau web_search_tool_result / web_fetch_tool_result. Untuk tipe tool_use, input adalah objek kosong dalam event ini, dan parameter input lengkap dirakit secara inkremental oleh event content_block_delta berikutnya. web_search_tool_result membawa array content lengkap dalam event ini, tidak dirakit secara inkremental.
Properti type stringNilai tetap: content_block_delta.index integerIndeks blok konten tempat event ini berada.delta objectObjek inkremental, dengan nilai type:
Properti type stringNilai tetap: content_block_stop.index integerIndeks blok konten yang berakhir.
Properti type stringNilai tetap: message_delta.delta objectBerisi stop_reason dan stop_sequence; untuk nilainya, lihat tabel respons non-streaming di atas.usage objectStatistik penggunaan token lengkap, termasuk input_tokens, output_tokens, cache_creation_input_tokens, dan cache_read_input_tokens.
Properti type stringNilai tetap: message_stop.Selain itu, respons streaming secara berkala mengirim event ping ({"type":"ping"}) untuk menjaga koneksi tetap aktif, yang dapat diabaikan oleh klien. | Contoh respons streamingBerikut adalah contoh respons qwen3.8-max, digunakan untuk mengilustrasikan bidang respons. |
FAQ
Setelah mengonfigurasi Claude Desktop atau Claude Code, uji koneksi gagal dengan errorModel discovery — Gateway /v1/models returned HTTP 404, atau URL permintaan berisi/v1/v1/models. Bagaimana cara mengatasinya?
Fitur penemuan model dari klien seperti Claude Desktop dan Claude Code secara otomatis menambahkan /v1/models ke base URL yang dikonfigurasi. Lakukan pemecahan masalah berdasarkan dua poin berikut:
- Base URL tidak boleh menggunakan
/v1/sebagai akhiran: Masukkan URL hingga/apps/anthropic(misalnya, untuk China (Beijing) masukkanhttps://dashscope.aliyuncs.com/apps/anthropic; untuk alamat wilayah lain, lihat "Informasi akses" di atas). Jika salah dimasukkan sebagai.../apps/anthropic/v1/, setelah klien menambahkan/v1/models, akan terbentuk path duplikat/v1/v1/models, yang menghasilkan HTTP 404. Oleh karena itu, saat terjadi 404, pertama-tama periksa apakah URL permintaan aktual berisi/v1/v1/yang duplikat; jika iya, hapus/v1/di akhir base URL. - Tambahkan model secara manual untuk melewati penemuan otomatis: Titik akhir kompatibel Anthropic Model Studio hanya menyediakan API Messages (
/v1/messages) dan tidak menyediakan API daftar model (/v1/models), sehingga permintaan penemuan model itu sendiri juga mengembalikan 404. Tambahkan model secara manual (misalnya,qwen3.7-plus) di bagian Models pada klien untuk melewati penemuan otomatis.