Skip to main content

Pesan yang Kompatibel dengan Anthropic

Panggil model melalui API Messages yang kompatibel dengan format Anthropic, serta lihat deskripsi parameter input dan output beserta contoh pemanggilan.

Dengan mengubah konfigurasi berikut, Anda dapat memigrasikan aplikasi Anthropic yang sudah ada ke Alibaba Cloud Model Studio:
  • 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).
Alibaba Cloud Model Studio menyediakan domain ruang kerja khusus untuk wilayah China (Beijing), Singapura, dan China (Hong Kong), yang memberikan performa lebih unggul dan stabilitas lebih tinggi untuk permintaan inferensi. Kami merekomendasikan Anda bermigrasi ke domain baru:
  • Wilayah China (Beijing): bermigrasi dari https://dashscope.aliyuncs.com ke https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • Wilayah Singapura: bermigrasi dari https://dashscope-intl.aliyuncs.com ke https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
  • Wilayah China (Hong Kong): bermigrasi dari https://cn-hongkong.dashscope.aliyuncs.com ke https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com
{WorkspaceId} merujuk pada ID ruang kerja Anda, yang dapat dilihat pada halaman Detail Ruang Kerja di konsol Alibaba Cloud Model Studio. Domain yang ada tetap tersedia.
  • 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
Saat melakukan panggilan, ganti {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)

base_url harus diganti dengan titik akhir kompatibel Model Studio (misalnya https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic; untuk titik akhir di wilayah lain, lihat informasi akses di atas), dan {WorkspaceId} harus diganti dengan ID Ruang Kerja Anda yang sebenarnya.

Metode otentikasi

api_key harus diganti dengan Kunci API Model Studio; dapat dimasukkan melalui header permintaan x-api-key atau Authorization: Bearer—salah satu saja sudah cukup.

Model

model harus diganti dengan nama model yang didukung Model Studio (misalnya qwen3.7-plus); untuk daftar lengkapnya, lihat deskripsi parameter model di bawah.

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 (/v1/messages) yang disediakan; API daftar model (/v1/models) tidak disediakan. Permintaan penemuan model dari klien mengembalikan 404; untuk cara menanganinya, lihat FAQ di bawah.

Parameter ekstensi

output_config (output terstruktur dan effort intensitas berpikir) adalah parameter ekstensi platform Model Studio yang tidak termasuk dalam definisi tipe SDK resmi dan harus diteruskan dalam body permintaan (lihat contoh "output terstruktur" di sebelah kanan); thinking.budget_tokens akan ditinggalkan—untuk integrasi baru, gunakan output_config.effort untuk mengontrol intensitas berpikir.

Isi Permintaan

model string (Wajib)Nama model. Model yang didukung adalah sebagai berikut.
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
max_tokens integer (Wajib)
  • qwen4-max, deepseek-v4.1-flash, deepseek-v4-pro, deepseek-v4-pro-0813, deepseek-v4-flash-0731, seri qwen3.8-max, qwen3.8-flash: jumlah token total maksimum untuk respons model ditambah konten rantai-pikiran; generasi berhenti lebih awal jika output melebihi nilai ini, dengan stop_reason bernilai max_tokens.
    max_tokens membatasi panjang respons model ditambah proses berpikir. Saat pemikiran mendalam diaktifkan, max_tokens > thinking.budget_tokens
  • glm-5.3: max_tokens adalah jumlah token total maksimum untuk respons model ditambah konten rantai-pikiran; generasi berhenti lebih awal jika output melebihi nilai ini, dengan stop_reason bernilai max_tokens. glm-5.3 mengabaikan parameter thinking.budget_tokens.
  • glm-5.2: Jika parameter thinking.budget_tokens tidak diteruskan, max_tokens adalah jumlah token total maksimum untuk respons model ditambah konten rantai-pikiran; generasi berhenti lebih awal jika output melebihi nilai ini, dengan stop_reason bernilai max_tokens. Jika parameter thinking.budget_tokens diteruskan, max_tokens hanya menjadi jumlah token maksimum untuk respons model, sedangkan jumlah token untuk bagian berpikir dikendalikan secara terpisah oleh thinking.budget_tokens.
  • Model lainnya: jumlah token maksimum untuk respons model. Jika konten yang dihasilkan melebihi nilai ini, generasi berhenti lebih awal, dengan stop_reason bernilai max_tokens.
    max_tokens tidak membatasi panjang proses berpikir. Saat pemikiran mendalam diaktifkan, jumlah token untuk bagian berpikir dikendalikan secara terpisah oleh thinking.budget_tokens.
system 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.
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.
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.
messages array (Wajib)
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".
type stringthinkingthinking stringsignature stringRingkasan berpikir dan teks sandi tanda tangan. Teruskan kembali blok thinking lengkap apa adanya dalam permintaan berikutnya.
Informasi Teks
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.
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.
Informasi Gambar (memerlukan model vision)
type string (Wajib)Nilai tetap: image.source object (Wajib)Sumber data gambar.
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.
Informasi Video (memerlukan model vision)
type string (Wajib)Nilai tetap: video.source object (Wajib)Sumber data video.
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.
Informasi Dokumen PDF
type string (Wajib)Nilai tetap: document.source object (Wajib)Sumber data dokumen PDF, yang berisi bidang-bidang berikut:
  • type (string): Wajib. Nilainya url atau base64.
  • url (string): Wajib jika source.type bernilai url. Menentukan URL file PDF.
  • media_type (string): Wajib jika source.type bernilai base64. Atur ke application/pdf.
  • data (string): Wajib jika source.type bernilai base64. Data PDF yang dikodekan Base64, tanpa awalan Data URI.
Pemahaman PDFInformasi Pemanggilan Tool (peran assistant; instruksi pemanggilan tool yang dikembalikan oleh model)
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.
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.
Informasi Hasil Tool (peran user; hasil eksekusi tool yang dikembalikan ke model)
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.
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.
cache_control 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).
type string (Wajib)ephemeralttl string (Opsional)Masa berlaku cache. Mendukung 5m dan 1h, secara default 5m.
stream 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.
top_p number (Opsional)Ambang probabilitas untuk nucleus sampling, yang mengontrol keragaman teks yang dihasilkan.
temperature dan top_p keduanya mengontrol keragaman teks yang dihasilkan. Kami merekomendasikan hanya mengatur salah satunya. Untuk informasi lebih lanjut, lihat Ikhtisar.
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.
thinking 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.
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 effort untuk mengontrol intensitas berpikir model.
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.
tools array (Opsional)Array definisi tool untuk skenario Function Call.
name string (Wajib)Nama tool.description string (Opsional)Deskripsi fungsi tool.input_schema object (Wajib)Definisi JSON Schema dari parameter input tool.
Selain tool kustom di atas, tools juga mendukung tool pencarian web sisi server Model Studio. Deklarasikan dalam tools untuk mengaktifkannya—tidak diperlukan pengambilan data di sisi klien.
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 x-anthropic-billing-header: cc_entrypoint=cli; dalam system; jika tidak, pencarian web tidak berlaku. Untuk klien resmi Anthropic seperti Claude Code, tidak diperlukan konfigurasi tambahan. Untuk informasi lebih lanjut, lihat Pencarian web.
Model berikut didukung: qwen4-max; seri Max, Flash, dan open-source Qwen3.8 (tidak termasuk Omni); seri Max, Plus, dan Flash Qwen3.7; seri Qwen3.6-Plus dan Qwen3.6-Flash; seri Qwen3.5-Plus dan Qwen3.5-Flash; deepseek-v4-pro, deepseek-v4-pro-0813, deepseek-v4-flash-0731, deepseek-v4.1-flash-1017; glm-5.2; kimi-k3; kimi-k3.1-pro. Pencarian web ditagih sama seperti strategi agen. Untuk informasi lebih lanjut, lihat Detail Penagihan.
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.
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.
tool_choice object (Opsional)Strategi pemilihan tool. Nilai berikut didukung:
  • {"type": "auto"}: Model memutuskan sendiri apakah akan memanggil tool (default).
  • {"type": "any"}: Memaksa model memanggil salah satu tool.
  • {"type": "none"}: Melarang model memanggil tool apa pun.
  • {"type": "tool", "name": "tool_name"}: Memaksa model memanggil tool tertentu.
output_config object (Opsional)Pengaturan parameter output.
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).
  • glm-5.3 (nilai default max): Nilai valid:
    • low: penalaran intensitas rendah
    • high: penalaran intensitas tinggi
    • max: penalaran intensitas maksimum
    Meneruskan nilai lain akan mengembalikan error.
  • glm-5.2, deepseek-v4-pro (nilai default max): Nilai valid:
    • high: penalaran intensitas tinggi
    • max: penalaran intensitas maksimum
    low dan medium dipetakan ke high, dan xhigh dipetakan ke max.
  • seri qwen3.8-max, qwen3.8-flash (nilai default xhigh): Nilai valid:
    • xhigh: penalaran intensitas tinggi
    • medium: penalaran intensitas menengah
    • low: penalaran intensitas rendah
    max dan high dipetakan ke xhigh.
format object (Opsional)Konfigurasi output terstruktur. Saat diaktifkan, model akan menghasilkan string JSON. Model yang berbeda memberikan tingkat dukungan yang berbeda:
  • Output terstruktur ketat: Berlaku untuk seri qwen3.8, seri qwen3.7, seri deepseek (tidak termasuk deepseek-v4-flash-0731 dan deepseek-v4-pro-0813), dan model seri glm. Model menghasilkan output secara ketat di bawah batasan kuat JSON Schema yang diteruskan, memastikan tipe bidang dan hierarki benar-benar konsisten.
  • Output terstruktur standar: Berlaku untuk model selain yang disebutkan di atas. Batasan bidang spesifik dalam Schema tidak berlaku secara default, dan API secara otomatis mengonversinya ke mode JSON standar (hanya menjamin bahwa output adalah string JSON yang valid). Untuk memicu mode JSON standar, permintaan harus memenuhi kedua batasan berikut: 1. meneruskan parameter output_config secara eksplisit; 2. konten system atau messages harus mengandung kata kunci "JSON" tanpa membedakan huruf besar/kecil. Jika prompt tidak mengandung kata kunci "JSON", API akan melemparkan exception: 'messages' must contain the word 'json' in some form.
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).
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.
web_search_requests integerJumlah pengambilan data pencarian web.web_fetch_requests integerJumlah perayapan halaman web.
cache_creation objectDetail pembuatan cache yang dijabarkan berdasarkan TTL. Penjumlahan jumlah token untuk kedua TTL sama dengan jumlah token yang digunakan untuk pembuatan cache ini.
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.
prompt_tokens_details objectDetail pembacaan cache. cached_tokens sama dengan cache_read_input_tokens; jangan dihitung ganda dalam statistik penggunaan.
cached_tokens integerJumlah token input yang dibaca dari cache.
  • Panggilan dasar
  • Output streaming
  • Pemikiran mendalam
  • Pemahaman gambar
  • Pemahaman video
  • Pemanggilan fungsi
  • Pencarian web
  • Cache eksplisit
  • Output terstruktur
Python
import anthropic
import os

client = anthropic.Anthropic(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
)

message = client.messages.create(
    model="qwen4-max",
    max_tokens=1024,
    system="You are a helpful assistant",
    messages=[
        {
            "role": "user",
            "content": "Who are you?"
        }
    ],
    thinking={"type": "disabled"},
)

print(message.content[0].text)

Respons Non-streaming

id stringIdentifier unik pesan.type stringNilai tetap: message.role stringNilai tetap: assistant.model stringNama model yang digunakan.content arrayArray konten.
Informasi Teks
type stringNilai tetap: text.text stringTeks respons yang dihasilkan oleh model.
Informasi thinking (dikembalikan saat pemikiran mendalam diaktifkan)
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.
Informasi pemanggilan tool (skenario Function Call)
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.
Informasi pemanggilan tool sisi server (skenario pencarian web; permintaan pengambilan data sisi server yang dikembalikan oleh model)
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.
Informasi hasil pencarian web (skenario pencarian web; hasil pengambilan data yang dikembalikan oleh server)
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.
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.
caller object (Opsional)Informasi pemanggil; type bernilai direct menunjukkan bahwa panggilan dimulai langsung oleh model.
Hasil web fetch (web_fetch_tool_result)
KolomJenisDeskripsi
typestringweb_fetch_tool_result
tool_use_idstringBersesuaian dengan server_tool_use.id.
contentobjectHasil pengambilan.
content.typestringweb_fetch_result
content.urlstringURL halaman web.
content.retrieved_atstringWaktu pengambilan.
content.contentobjectDokumen halaman web.
content.content.typestringdocument
content.content.titlestringJudul halaman web.
content.content.sourceobjectKonten dokumen.
content.content.source.typestringtext
content.content.source.media_typestringtext/plain
content.content.source.datastringKonten dokumen.
callerobjectInformasi pemanggil.
caller.typestringdirect
stop_reason 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.
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.
web_search_requests integerJumlah pengambilan data pencarian web.web_fetch_requests integerJumlah perayapan halaman web.
  • Respons dasar
  • Respons pencarian web
Berikut adalah contoh respons qwen3.8-max, digunakan untuk mengilustrasikan bidang respons.
{
  "id": "msg_e2898f19-fc0e-4cb3-bd9b-5b7dc4ea3bc9",
  "type": "message",
  "role": "assistant",
  "model": "qwen3.8-max",
  "content": [
    {
      "type": "thinking",
      "thinking": "Let me analyze this problem...",
      "signature": ""
    },
    {
      "type": "text",
      "text": "Hello! I am Qwen..."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 22,
    "output_tokens": 223,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Respons Streaming

message_startEvent pertama dari stream, menandai awal pesan.
type stringNilai tetap: message_start.message objectObjek pesan awal, dengan content berupa array kosong dan usage hanya berisi input_tokens dan output_tokens.
content_block_startDikirim saat setiap blok konten dimulai, menandai indeks dan tipe blok konten baru.
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.
content_block_deltaEvent pembaruan inkremental dari blok konten. Beberapa event seperti ini dikirim untuk blok konten yang sama.
type stringNilai tetap: content_block_delta.index integerIndeks blok konten tempat event ini berada.delta objectObjek inkremental, dengan nilai type:
  • text_delta: Inkremen teks, berisi bidang text.
  • thinking_delta: Inkremen berpikir, berisi bidang thinking.
  • signature_delta (signature): qwen4-max, thinking.display="summarized": Blok thinking Anthropic Messages berisi ringkasan thinking dan teks sandi signature. Dalam 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": signature="".
  • input_json_delta: Inkremen parameter input pemanggilan tool, berisi bidang partial_json.
content_block_stopEvent akhir blok konten.
type stringNilai tetap: content_block_stop.index integerIndeks blok konten yang berakhir.
message_deltaEvent pembaruan tingkat pesan yang dikirim setelah semua blok konten berakhir, berisi alasan penghentian dan statistik penggunaan token lengkap.
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.
message_stopEvent terakhir dalam stream, menandai akhir pesan.
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.
{"type":"message_start","message":{"id":"msg_xxx","type":"message","role":"assistant","model":"qwen3.8-max","content":[],"usage":{"input_tokens":15,"output_tokens":0}}}
{"type":"content_block_start","index":0,"content_block":{"type":"thinking","thinking":"","signature":""}}
{"type":"content_block_delta","index":0,"delta":{"type":"thinking_delta","thinking":"Here's a thinking process:\n\n1. **Analyze User Input:**\n   - **Topic:** Artificial Intelligence (AI)\n   - **Request:** Give a brief introduction to artificial intelligence."}}
{"type":"content_block_delta","index":0,"delta":{"type":"signature_delta","signature":""}}
{"type":"content_block_stop","index":0}
{"type":"content_block_start","index":1,"content_block":{"type":"text","text":""}}
{"type":"content_block_delta","index":1,"delta":{"type":"text_delta","text":"Artificial intelligence (AI) is an important branch of computer science..."}}
{"type":"content_block_stop","index":1}
{"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"input_tokens":15,"output_tokens":1078,"cache_creation_input_tokens":0,"cache_read_input_tokens":0}}
{"type":"message_stop"}

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) masukkan https://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.