Migrasikan aplikasi Anthropic Anda ke Model Studio dengan mengubah tiga pengaturan. Topik ini mencakup parameter permintaan dan respons beserta contoh kode.
Untuk memigrasikan aplikasi Anthropic yang sudah ada ke Model Studio, ubah pengaturan berikut:
Ganti
Setelah mengonfigurasi Claude Desktop atau Claude Code, uji koneksi gagal dengan
api_key: Ganti dengan Kunci API Model Studio.base_url: Ganti dengan titik akhir Model Studio yang tercantum di bawah.model: Ganti dengan nama model yang didukung, sepertiqwen3.7-plus.
- Singapura
- China (Beijing)
- Jerman (Frankfurt)
- AS (Virginia)
- Jepang (Tokyo)
SDK
base_url: 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 aktual Anda.
Otentikasi: Masukkan Kunci API Model Studio Anda di header x-api-key atau header Authorization: Bearer.
Isi Permintaanmodelstring (Wajib)Nama model. Model yang didukung:
Model yang Didukung Qwen-Max: qwen3.8-max, qwen3.7-max, qwen3.7-max-2026-05-20, qwen3.7-max-2026-06-08, qwen3.6-max-preview, qwen3-max, qwen3-max-2026-01-23, qwen3-max-previewQwen-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-latest, qwen-plus-2025-09-11Qwen-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-Turbo: qwen-turboQwen-Coder: qwen3-coder-next, qwen3-coder-plus, qwen3-coder-plus-2025-09-23, qwen3-coder-flashQwen-VL: qwen3-vl-plus, qwen3-vl-flash, qwen-vl-max, qwen-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-pro, deepseek-v4-pro-0813, deepseek-v4-flash, deepseek-v4-flash-0731, kimi-k3, kimi-k2.7-code, kimi-k2.5, kimi-k2-thinking, glm-5.1, glm-5, glm-4.7, glm-4.6, MiniMax-M2.5, MiniMax-M2.1 integer (Wajib)
string atau array (Opsional)Prompt sistem yang menentukan perilaku model. system merupakan parameter tingkat atas — array messages tidak menerima peran system.String setara dengan satu blok type="text". Gunakan array untuk menandai titik pemutusan cache prompt.
Properti type string (Wajib)Nilai tetap: text.text string (Wajib)Teks prompt sistem.cache_control objek (Opsional)Titik pemutusan cache prompt. Pada cache hit, permintaan selanjutnya ditagih dengan laju baca cache. Hanya berisi properti type dengan nilai tetap ephemeral.array (Wajib)Array pesan, disusun secara bergantian dalam giliran user/assistant.
Elemen array messages role string (Wajib)Peran pesan. Nilai valid: user, assistant.content string atau array (Wajib)Berupa string teks biasa atau array konten terstruktur. String setara dengan satu blok content dengan type="text".
Jenis elemen array content Teks
Properti type string (Wajib)Nilai tetap: text.text string (Wajib)Konten teks.cache_control objek (Opsional)Titik pemutusan cache prompt. Hanya berisi properti type dengan nilai tetap ephemeral.
Properti type string (Wajib)Nilai tetap: image.source objek (Wajib)Sumber data gambar.
Properti type string (Wajib)Nilai valid: url (URL gambar publik), base64 (data terenkripsi 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 terenkripsi Base64. Wajib jika type bernilai base64.
Properti type string (Wajib)Nilai tetap: video.source objek (Wajib)Sumber data video.
Properti type string (Wajib)Nilai valid: url (URL video publik), base64 (data terenkripsi 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 terenkripsi Base64. Wajib jika type bernilai base64.
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 objek (Wajib)Parameter input pemanggilan tool. Strukturnya ditentukan oleh input_schema tool yang sesuai dalam tools.cache_control objek (Opsional)Titik pemutusan cache prompt. Hanya berisi properti type dengan nilai tetap ephemeral. Konten pemanggilan tool berpartisipasi dalam prefiks cache.
Properti type string (Wajib)Nilai tetap: tool_result.tool_use_id string (Wajib)Bersesuaian dengan id dalam blok tool_use.content string (Wajib)Konten yang dikembalikan oleh tool.cache_control objek (Opsional)Titik pemutusan cache prompt. Hanya berisi properti type dengan nilai tetap ephemeral.boolean (Opsional)Apakah akan mengaktifkan streaming. Nilai default: false.temperature number (Opsional)Mengontrol keragaman teks yang dihasilkan. Rentang nilai: [0, 2). Nilai yang lebih tinggi menghasilkan respons yang lebih acak.Rentang ini berbeda dari rentang resmi Anthropic yaitu [0.0, 1.0]. Saat memigrasikan dari Anthropic, pastikan untuk memverifikasi nilai parameter ini. number (Opsional)Ambang batas probabilitas pengambilan sampel nucleus.Kedua parametertop_k integer (Opsional)Ukuran kumpulan kandidat selama pengambilan sampel.stop_sequences array (Opsional)Urutan teks yang memicu penghentian generasi. Output berakhir sebelum urutan yang cocok.Setelah pencocokan, stop_reason dalam respons tetap bernilai end_turn, dan respons tidak menyertakan urutan yang cocok.objek (Opsional)Konfigurasi rantai-pikiran diperluas. Saat diaktifkan, model melakukan penalaran sebelum merespons, dan respons mencakup blok konten bertipe thinking. Tidak semua model mendukung mode berpikir.
Properti type string (Wajib)Nilai valid: enabled (aktifkan mode berpikir), disabled (nonaktifkan mode berpikir).budget_tokens integer (Opsional, akan ditinggalkan)
Parameter ini akan ditinggalkan. Untuk integrasi baru, gunakan Token maksimum untuk proses berpikir. Parameter ini terpisah dari max_tokens: ia membatasi bagian berpikir, sedangkan max_tokens membatasi balasan akhir. Anggaran token yang lebih besar memungkinkan analisis lebih menyeluruh terhadap pertanyaan kompleks. Berlaku saat type bernilai enabled.array (Opsional)Definisi tool untuk pemanggilan fungsi.
Elemen array tools name string (Wajib)Nama tool.description string (Opsional)Deskripsi fungsi tool.input_schema objek (Wajib)Definisi skema JSON parameter input tool.objek (Opsional)Strategi pemilihan tool:
objek (Opsional)
Properti effort string (Opsional)Mengontrol intensitas inferensi model. Nilai valid dan nilai default bervariasi berdasarkan model.
objek (Opsional)Konfigurasi output terstruktur. Saat diaktifkan, model mengembalikan string JSON. Perilaku bervariasi berdasarkan model:
Properti type string (Wajib)Nilai tetap: json_schema.schema objek (Wajib)Objek skema JSON yang mengikuti spesifikasi standar JSON Schema. Harus mencakup type (tipe data), properties (definisi bidang), required (array nama bidang wajib), dan additionalProperties (harus diatur ke false). |
Python |
Respons Non-streamingidstringIdentifier pesan unik.type stringNilai tetap: message.role stringNilai tetap: assistant.model stringModel yang digunakan untuk generasi.content arrayArray konten.
Tipe Elemen Array Konten Teks
Properti type stringNilai tetap: text.text stringTeks respons yang dihasilkan oleh model.
Properti type stringNilai tetap: thinking.thinking stringPenalaran model sebelum respons akhir.signature stringSaat ini tetap sebagai string kosong.
Properti type stringNilai tetap: tool_use.id stringIdentifier unik pemanggilan tool, digunakan untuk mencocokkan tool_result.name stringNama tool yang dipanggil.input objekParameter input pemanggilan tool.stringAlasan penghentian generasi. Nilai valid: end_turn (penyelesaian normal), max_tokens (batas token tercapai), tool_use (pemanggilan tool).stop_sequence stringSelalu null.usage objekStatistik penggunaan token.Dalam panggilan streaming, bidang usage pada event message_start hanya berisi input_tokens dan output_tokens. Keempat bidang lengkap dikembalikan dalam event message_delta.
Properti input_tokens integerToken input.output_tokens integerToken output.cache_creation_input_tokens integerToken yang dikonsumsi untuk pembuatan cache.cache_read_input_tokens integerToken yang dikonsumsi dari pembacaan cache. | Contoh Respons |
Respons Streamingmessage_startEvent stream pertama, menandai awal pesan.
Properti type stringNilai tetap: message_start.message objekObjek pesan awal. content adalah array kosong, dan usage hanya berisi input_tokens dan output_tokens.
Properti type stringNilai tetap: content_block_start.index integerIndeks berbasis 0 yang bersesuaian dengan posisi dalam array content.content_block objekObjek awal blok konten. Nilai type adalah text, thinking, atau tool_use. Untuk tipe tool_use, bidang input adalah objek kosong dalam event ini, dan parameter input lengkap dirakit dari delta content_block_delta berikutnya.
Properti type stringNilai tetap: content_block_delta.index integerIndeks blok konten terkait.delta objekObjek delta. Nilai type:
Properti type stringNilai tetap: content_block_stop.index integerIndeks blok konten yang berakhir.
Properti type stringNilai tetap: message_delta.delta objekBerisi stop_reason dan stop_sequence. Untuk nilai valid, lihat tabel Respons Non-streaming di atas.usage objekStatistik 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. Klien dapat mengabaikannya. | Contoh respons streaming |
FAQ
Setelah mengonfigurasi Claude Desktop atau Claude Code, uji koneksi gagal denganModel discovery — Gateway /v1/models returned HTTP 404, atau URL permintaan berisi/v1/v1/models. Bagaimana cara memperbaikinya?
Fitur penemuan model klien seperti Claude Desktop dan Claude Code secara otomatis menambahkan /v1/models ke URL dasar yang dikonfigurasi. Periksa dua hal berikut:
- Jangan mengakhiri URL dasar dengan
/v1/: URL harus berakhir di/apps/anthropic(misalnya, untuk China (Beijing) gunakanhttps://dashscope.aliyuncs.com/apps/anthropic; lihat informasi titik akhir di atas untuk wilayah lainnya). Jika Anda salah memasukkan.../apps/anthropic/v1/, klien akan menambahkan/v1/modelsdan menghasilkan path duplikat/v1/v1/models, yang mengembalikan HTTP 404. Oleh karena itu, saat Anda mendapatkan 404, pertama-tama periksa apakah URL permintaan aktual berisi/v1/v1/yang duplikat; jika iya, hapus/v1/di akhir URL dasar. - Tambahkan model secara manual untuk melewati penemuan: Titik akhir kompatibel Anthropic Model Studio hanya menyediakan API Messages (
/v1/messages) dan tidak menyediakan titik akhir daftar model (/v1/models), sehingga permintaan penemuan model mengembalikan 404. Tambahkan model secara manual (misalnya,qwen3.7-plus) di bagian Models pada klien untuk melewati penemuan otomatis.