Panggil model melalui API Chat yang kompatibel dengan OpenAI, dan lihat deskripsi parameter input dan output serta contoh pemanggilan.
- Tiongkok (Beijing)
- Singapura
- AS (Virginia)
- Jerman (Frankfurt)
- Jepang (Tokyo)
- Hong Kong (Tiongkok)
base_url: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1URL permintaan HTTP: POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions{WorkspaceId} dengan ID Ruang Kerja Anda yang sebenarnya.
Anda harus terlebih dahulu mendapatkan dan mengonfigurasi Kunci API. Jika Anda memanggil API melalui SDK OpenAI, Anda perlu menginstal SDK.
Badan permintaanmodelstring(Wajib)Nama model.Model yang didukung: model bahasa besar Qwen (versi komersial dan sumber terbuka), Qwen-VL, Qwen-Coder, Qwen-Omni, Qwen-Math, DeepSeek (penyediaan langsung Alibaba Cloud, penyediaan langsung SiliconFlow, penyediaan langsung Kuaishou Wanqing), Kimi (penyediaan langsung Alibaba Cloud, penyediaan langsung Moonshot AI), GLM (penyediaan langsung Alibaba Cloud), MiniMax (penyediaan langsung Alibaba Cloud, penyediaan langsung Xiyu Technology).Model penyediaan langsung pihak ketiga hanya tersedia di wilayah Tiongkok (Beijing) pada situs Tiongkok. Sebelum memanggilnya, Anda harus mengaktifkan layanan terkait di konsol Bailian (contoh dengan SiliconFlow DeepSeek: cari deepseek → temukan kartu model SiliconFlow DeepSeek → klik Aktifkan Sekarang → Konfirmasi Otorisasi). Qwen-Audio tidak mendukung protokol yang kompatibel dengan OpenAI; hanya mendukung protokol DashScope.Untuk nama model dan penagihan spesifik, lihatkonsol Bailian.messages array(Wajib)Konteks yang diteruskan ke model bahasa besar, diatur dalam urutan percakapan.
Jenis pesan Pesan Sistem object(Opsional)Pesan sistem, digunakan untuk menentukan peran, nada, tujuan tugas, atau batasan model bahasa besar. Umumnya ditempatkan di posisi pertama dalam array messages.Pengaturan Pesan Sistem tidak disarankan untuk model QwQ; untuk model QVQ, Pesan Sistem tidak berpengaruh.
Properti content string(Wajib)Instruksi sistem, digunakan untuk menentukan peran, aturan perilaku, gaya respons, dan batasan tugas model.rolestring(Wajib)Peran pesan sistem, tetap system .object(Wajib)Pesan pengguna, digunakan untuk meneruskan pertanyaan, instruksi, atau konteks ke model.
Properti content string or array(Wajib)Konten pesan. Jika input hanya berupa teks, tipenya string; jika input berisi data multimodal seperti gambar, atau cache eksplisit diaktifkan, tipenya array.
Properti untuk model multimodal atau saat cache eksplisit diaktifkan type string(Wajib)Nilai yang valid:
stringTeks input. Wajib saat type adalah text.image_urlobjectInformasi gambar input. Wajib saat type adalah image_url.
Properti url string (Wajib)URL gambar atau URL Data Base64. Untuk meneruskan file lokal, lihat Pemahaman gambar dan video.detail string (Opsional)Resolusi pemrosesan gambar. Berlaku untuk qwen4-max; nilai defaultnya adalah high.Saat max_pixels tidak ditentukan:
max_pixels ditentukan secara eksplisit, nilai ini digunakan sebagai batas atas piksel dan lebih diutamakan daripada detail. Nilai maksimumnya adalah 16777216. Di Chat Completions, max_pixels berada di tingkat yang sama dengan image_url; di DashScope, berada di tingkat yang sama dengan image.Untuk gambar beresolusi tinggi, menggunakan high umumnya mengonsumsi lebih banyak token input daripada low.Di Chat Completions, detail dapat diteruskan di dalam image_url atau di tingkat yang sama dengan image_url; di DashScope, diteruskan di tingkat yang sama dengan image.objectInformasi audio input. Wajib saat type adalah input_audio.
Properti data string (Wajib)URL audio atau URL Data Base64. Untuk meneruskan file lokal, lihat Input file lokal berformat Base64.formatstring (Wajib)Format audio input, seperti mp3 atau wav.arrayInformasi video input dalam bentuk daftar gambar. Wajib saat type adalah video. Untuk penggunaannya, lihat Pemahaman video (Qwen-VL, QVQ) atau Pemahaman video (Qwen-Omni).Nilai contoh:objectInformasi file video input. Wajib saat type adalah video_url.Qwen-VL hanya dapat memahami informasi visual dalam file video, sedangkan Qwen-Omni dapat memahami informasi visual dan audio dalam file video.
Properti url string (Wajib)URL publik atau URL Data Base64 dari file video. Untuk memasukkan file video lokal, lihat Input file lokal berformat Base64.float (Opsional)Frame yang diekstraksi per detik. Rentang nilai: [0.1, 10]; nilai default: 2.0.Untuk MiniMax/MiniMax-M3.1-Flash dan MiniMax/MiniMax-M3, rentang nilai fps adalah [0.2, 5], dan nilai defaultnya adalah 1.
Fungsionalitas fps memiliki dua fungsi:
fps yang lebih besar cocok untuk skenario gerakan cepat (seperti acara olahraga dan film aksi), sedangkan fps yang lebih kecil cocok untuk video panjang atau konten yang relatif statis.
Nilai contoh
integer (Opsional)Menetapkan ambang batas piksel minimum untuk gambar atau frame video input. Saat piksel gambar atau frame video input kurang dari min_pixels, gambar atau frame video akan diperbesar hingga total pikselnya melebihi min_pixels. Untuk model dan nilai yang berlaku, lihat deskripsi di bawah.
Kisaran nilai
Nilai contoh
integer (Opsional)Digunakan untuk menetapkan ambang batas piksel maksimum untuk gambar atau frame video input. Saat piksel gambar atau video input berada dalam rentang [min_pixels, max_pixels], model mengenali gambar asli. Saat piksel gambar input melebihi max_pixels, gambar akan diperkecil hingga total pikselnya kurang dari max_pixels. Untuk model dan nilai yang berlaku, lihat deskripsi di bawah.
Kisaran nilai
Nilai contoh
integer (Opsional)Anggaran total piksel setelah ekstraksi frame video.
Nilai maksimum
Nilai contoh
object (Opsional)Hanya didukung oleh qwen4-max. Menentukan posisi akhir prefiks cache. Untuk informasi selengkapnya, lihat Cache eksplisit (Qwen4).
Properti mode string (Wajib)Hanya explicit yang didukung; harus diteruskan secara eksplisit saat menetapkan breakpoint.object (Opsional)Digunakan untuk mengaktifkan cache eksplisit. Dokumentasi terkait: Cache eksplisit.
Properti type string (Wajib)Hanya ephemeral yang didukung.
Properti (Qwen4) Hanya didukung oleh qwen4-max. Penanda cache blok konten Qwen4 juga mendukung ttl, dengan opsi 5m dan 1h, dan defaultnya adalah 5m. Untuk informasi selengkapnya, lihat Cache eksplisit (Qwen4).type string (Wajib)ephemeralttl string (Opsional)Masa berlaku cache. Mendukung 5m dan 1h, dan defaultnya adalah 5m.string(Wajib)Peran pesan pengguna, tetap user.object (Opsional)Balasan model. Umumnya diteruskan kembali ke model sebagai konteks dalam percakapan multi-putaran.
Properti content string (Opsional)Konten teks balasan model. Saat tool_calls disertakan, content bisa kosong; jika tidak, content wajib diisi.rolestring(Wajib)Peran pesan asisten, tetap assistant.encrypted_content stringqwen4-max, thinking_display="summarized": Parameter pengaktifan harus diteruskan pada setiap putaran. Klien hanya dapat meneruskan kembali ciphertext apa adanya; tidak dapat membaca, memotong, mengodekan ulang, mengubah, atau menggabungkan ciphertext dari beberapa putaran. Ringkasan tidak dapat menggantikan rantai-pikiran historis. Ringkasan dan enkripsi rantai-pikiran. Ciphertext harus diteruskan kembali apa adanya.partialboolean (Opsional), nilai default adalah falseMenentukan apakah akan mengaktifkan mode parsial.Nilai yang valid:
array (Opsional)Informasi alat dan parameter input yang dikembalikan setelah memulai Function Calling, berisi satu atau lebih objek. Diperoleh dari field tool_calls respons model pada putaran sebelumnya.
Properti id string (Wajib)ID respons alat.type string (Wajib)Jenis alat. Saat ini hanya function yang didukung.function object (Wajib)Informasi alat dan parameter input.
Properti name string (Wajib)Nama alat.arguments string (Wajib)Informasi parameter input, sebagai string berformat JSON.integer (Wajib)Indeks informasi alat saat ini dalam array tool_calls.object (Opsional)Informasi keluaran alat.
Properti content string(Wajib)Konten keluaran fungsi alat, yang harus berupa string. Jika alat mengembalikan data terstruktur (seperti JSON), Anda harus menserialisasinya menjadi string.rolestring(Wajib)Tetap tool.tool_call_idstring(Wajib)ID yang dikembalikan setelah memulai Function Calling, diperoleh melalui completion.choices[0].message.tool_calls[$index].id, digunakan untuk mengidentifikasi alat yang sesuai dengan Pesan Alat.object (Opsional)Hanya didukung oleh qwen4-max. Konfigurasi cache di tingkat teratas permintaan. SDK Python meneruskan parameter non-standar tingkat teratas melalui extra_body; SDK Node.js dan curl meneruskannya secara langsung. Untuk informasi selengkapnya, lihat Cache eksplisit (Qwen4).
Properti mode string (Opsional)implicit: breakpoint cache ditetapkan secara otomatis, tidak diperlukan konfigurasi manual.explicit: breakpoint tidak ditetapkan secara otomatis; pembuatan cache eksplisit memerlukan breakpoint manual.ttl string (Opsional)Masa berlaku cache. Mendukung 5m dan 1h, dan defaultnya adalah 5m.Berlaku untuk semua breakpoint cache dalam permintaan ini. Jika ttl tingkat teratas tidak diatur, ttl pada penanda cache_control terakhir yang digunakan; jika penanda tersebut tidak mengatur ttl atau tidak ada penanda, 5m digunakan.boolean (Opsional) Nilai default adalah falseMenentukan apakah akan membalas dalam mode keluaran streaming. Dokumentasi terkait: Keluaran streamingNilai yang valid:
true disarankan, karena meningkatkan pengalaman membaca dan mengurangi risiko timeout.Timeout maksimum untuk pemanggilan non-streaming tidak kurang dari 300 detik, dan durasi sebenarnya bervariasi tergantung pada wilayah penyebaran dan model yang digunakan. Jika permintaan tidak selesai sebelum timeout, layanan akan menginterupsi permintaan dan mengembalikan konten yang telah dihasilkan (alih-alih melaporkan error). Untuk skenario dengan keluaran panjang, pastikan menggunakan pemanggilan streaming. Untuk informasi selengkapnya tentang timeout, lihat Ikhtisar model generasi teks. object (Opsional)Hanya digunakan untuk permintaan streaming dengan stream bernilai true. Jangan meneruskan stream_options dalam permintaan non-streaming.
Properti include_usage boolean (Opsional)Saat keluaran streaming, potongan data terakhir berisi usage, dan choices pada potongan tersebut adalah array kosong.array(Opsional) Nilai default adalah ["text"]Modalitas data keluaran, hanya berlaku untuk model Qwen-Omni. Dokumentasi terkait: Non-realtime (Qwen-Omni)Nilai yang valid:
qwen3.8-omni-flash hanya mengeluarkan teks. Untuk contoh, lihat Qwen3.8-Omni-Flash.audioobject (Opsional)Suara dan format audio keluaran, berlaku untuk model Qwen-Omni yang mendukung keluaran audio, dan parameter modalities harus diatur ke ["text","audio"]. Dokumentasi terkait: Non-realtime (Qwen-Omni)
Properti voice string (Wajib)Suara audio keluaran. Lihat Non-realtime (Qwen-Omni).formatstring (Wajib)Format audio keluaran, yang hanya dapat diatur ke wav.float (Opsional)Suhu sampling, yang mengontrol keragaman teks yang dihasilkan model.Suhu yang lebih tinggi menghasilkan teks yang lebih beragam, sedangkan suhu yang lebih rendah menghasilkan teks yang lebih deterministik.Rentang nilai: [0, 2)MiniMax/MiniMax-M3.1-Flash dan MiniMax/MiniMax-M3 menggunakan nilai tetap 1.0, yang tidak dapat dikustomisasi; nilai lain tidak berpengaruh.Baik temperature maupun top_p mengontrol keragaman teks yang dihasilkan. Kami merekomendasikan agar Anda hanya mengatur salah satunya. Untuk informasi selengkapnya, lihat Ikhtisar.
Nilai default temperature
Kami tidak menyarankan mengubah nilai temperature default model QVQ.top_p float (Opsional)Ambang probabilitas untuk nucleus sampling, yang mengontrol keragaman teks yang dihasilkan model.top_p yang lebih tinggi menghasilkan teks yang lebih beragam, sedangkan top_p yang lebih rendah menghasilkan teks yang lebih deterministik.Rentang nilai: (0, 1.0]MiniMax/MiniMax-M3.1-Flash dan MiniMax/MiniMax-M3 menggunakan nilai tetap 0.95, yang tidak dapat dikustomisasi; nilai lain tidak berpengaruh.Baik temperature maupun top_p mengontrol keragaman teks yang dihasilkan. Kami merekomendasikan agar Anda hanya mengatur salah satunya. Untuk informasi selengkapnya, lihat Ikhtisar.
Nilai default top_p
qwen3.8-max, qwen3.8-max-0902, qwen3.8-flash, qwen3.8-2.4t-a95b, qwen3.8-27b), Qwen3.7 (mode non-thinking), Qwen3.6 (mode non-thinking), Qwen3.5-Omni, Qwen3.5 (mode non-thinking), Qwen3 (mode non-thinking), seri Qwen3-Instruct, seri Qwen3-Coder, seri qwen-max, seri qwen-plus (mode non-thinking), seri qwen-flash (mode non-thinking), seri sumber terbuka Qwen 2.5, seri qwen-coder, qwen-long, qwen-doc-turbo, Qwen3-VL (non-thinking): 0.8;Qwen3.8-Omni-Flash: 0.95 dalam mode thinking, 0.8 dalam mode non-thinking;Seri QVQ: 0.5;seri qwen-math, seri Qwen3-Omni-Flash: 1.0;Model berikut dalam mode thinking (qwen3.8-max, qwen3.8-max-0902, qwen3.8-flash, qwen3.8-2.4t-a95b, qwen3.8-27b), Qwen3.7 (mode thinking), Qwen3.6 (mode thinking), Qwen3.5 (mode thinking), Qwen3 (mode thinking), Qwen3-VL (mode thinking), Qwen3-Thinking, seri QwQ, Qwen3-Omni-Captioner, qwen-plus-character: 0.95Seri DeepSeek (disediakan langsung oleh Alibaba Cloud): deepseek-v4-pro, deepseek-r1-distill-qwen versi distilasi: 0.95;Seri DeepSeek (disediakan langsung oleh SiliconFlow): siliconflow/deepseek-v3.2, siliconflow/deepseek-v3.1-terminus, siliconflow/deepseek-r1-0528, siliconflow/deepseek-v3-0324: 1.0;Seri DeepSeek (disediakan langsung oleh Kuaishou Wanqing): vanchin/deepseek-v3.2-think, vanchin/deepseek-v3.1-terminus: 0.95; vanchin/deepseek-v3.2-speciale: 0.9; vanchin/deepseek-r1: 0.8; vanchin/deepseek-v3, vanchin/deepseek-ocr: 1.0;Seri Kimi (disediakan langsung oleh Alibaba Cloud): kimi-k2.7-code, kimi-k2.6, kimi-k2.5: 0.95;Seri Kimi (disediakan langsung oleh Moonshot AI): kimi/kimi-k3, kimi/kimi-k3.1-pro, kimi/kimi-k3.1-pro-highspeed, kimi/kimi-k2.7-code-highspeed, kimi/kimi-k2.7-code, kimi/kimi-k2.6, kimi/kimi-k2.5: 0.95;Seri GLM (disediakan langsung oleh Alibaba Cloud): 0.95;Seri GLM (disediakan langsung oleh ZHIPU): ZHIPU/GLM-5.1, ZHIPU/GLM-5: 0.95;Seri MiniMax (disediakan langsung oleh Alibaba Cloud): MiniMax-M2.5: 0.95;Seri MiniMax (disediakan langsung oleh Xiyu Technology): MiniMax/MiniMax-M3.1-Flash, MiniMax/MiniMax-M3: 0.95; MiniMax/MiniMax-M2.7, MiniMax/MiniMax-M2.5, MiniMax/MiniMax-M2.1: 0.9.Seri MiMo (disediakan langsung oleh Xiaomi): xiaomi/mimo-v2.5-pro: 0.95, rentang [0.01, 1.0]; xiaomi/mimo-v2.6-pro-ultraspeed: 0.95, kustomisasi tidak didukung, dan nilai lain yang diteruskan tetap berlaku sebagai 0.95.Modifikasi nilai top_p default model QVQ tidak disarankan.top_k integer (Opsional)Jumlah Token kandidat yang digunakan untuk sampling selama generasi. Semakin besar nilainya, semakin acak keluarannya; semakin kecil nilainya, semakin deterministik keluarannya. Jika diatur ke null atau lebih besar dari 100, strategi top_k dinonaktifkan dan hanya strategi top_p yang berlaku. Nilainya harus berupa integer yang lebih besar dari atau sama dengan 0.
Nilai top_k default Seri QVQ: 10;Seri QwQ: 40;seri qwen-math, seri qwen-audio-turbo: 1;Seri Qwen3-Omni-Flash: 50;Semua model lainnya: 20.Seri GLM (disediakan langsung oleh Alibaba Cloud): 20;Seri DeepSeek/Kimi/MiniMax tidak mendukung parameter top_k. Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Metode konfigurasinya adalah: extra_body={"top_k":xxx}. Modifikasi nilai top_k default model QVQ tidak disarankan.repetition_penalty float (Opsional)Tingkat pengulangan dalam urutan berturut-turut selama generasi model. Meningkatkan repetition_penalty dapat mengurangi tingkat pengulangan konten yang dihasilkan model, dengan 1.0 berarti tanpa penalti. Tidak ada rentang nilai yang ketat; hanya perlu lebih besar dari 0.
Nilai default repetition_penalty
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Metode konfigurasinya adalah: extra_body={"repetition_penalty":xxx}. Modifikasi nilai repetition_penalty default model QVQ tidak disarankan.frequency_penalty float (Opsional)Didukung pada qwen4-max. Menerapkan penalti berdasarkan jumlah kemunculan Token, untuk menyesuaikan generasi konten berulang.presence_penalty float (Opsional)Mengontrol tingkat pengulangan konten saat model menghasilkan teks.Rentang nilai: [-2.0, 2.0]. Nilai positif mengurangi pengulangan; nilai negatif meningkatkan pengulangan.Pada skenario yang memerlukan keragaman, keseruahan, atau kreativitas, seperti penulisan kreatif atau brainstorming, disarankan meningkatkan nilai ini; pada skenario yang menekankan konsistensi dan akurasi istilah, seperti dokumentasi teknis atau teks formal, disarankan menurunkan nilai ini.
Nilai default presence_penalty Model berikut dalam mode non-thinking ( qwen4-max, qwen3.8-max, qwen3.8-max-0902, qwen3.8-flash, qwen3.8-2.4t-a95b, qwen3.8-27b), Qwen3.7 (mode non-thinking), Qwen3.6 (mode non-thinking), Qwen3.5-Omni, Qwen3.5 (mode non-thinking), Qwen3 (mode non-thinking), seri Qwen3-Instruct/1.7b/4b (mode thinking), seri QVQ, qwen-max, seri qwen2.5-vl, dan Qwen3-VL (mode non-thinking): 1.5;Qwen3.8-Omni-Flash: 0.0 dalam mode thinking dan 1.5 dalam mode non-thinking;qwen-plus/qwen-plus-latest/2025-04-28 (mode thinking), qwen-turbo-2025-04-28 (mode thinking): 0.5;Semua lainnya defaultnya 0.0.Seri DeepSeek (penyediaan langsung Alibaba Cloud): deepseek-r1-distill-qwen versi distilasi: 1;Seri Kimi (penyediaan langsung Alibaba Cloud): kimi-k2.7-code, kimi-k2.6, kimi-k2.5: 0.0;Seri Kimi (penyediaan langsung Moonshot AI): 0.0;Seri MiniMax (penyediaan langsung Alibaba Cloud): MiniMax-M2.5: 0.0;Model DeepSeek/Kimi/GLM/MiniMax lainnya tidak memiliki nilai default.
Cara kerjanya Jika nilai parameter adalah angka positif, model menerapkan penalti pada token yang sudah ada dalam teks saat ini (penalti tidak terkait dengan jumlah kemunculan teks tersebut), mengurangi probabilitas token-token itu muncul kembali. Hal ini mengurangi pengulangan konten dan meningkatkan keragaman kata.
Contoh Prompt: Terjemahkan kalimat ini ke dalam Bahasa Mandarin: "Film ini bagus. Alur ceritanya bagus, aktingnya bagus, musiknya bagus, dan secara keseluruhan, seluruh film ini sungguh bagus. Bahkan, film ini sangat bagus. Alur ceritanya sangat bagus, aktingnya sangat bagus, dan musiknya sangat bagus."Nilai parameter 2.0: Film ini bagus. Alur ceritanya fantastis, aktingnya luar biasa, dan musiknya juga sangat indah. Secara keseluruhan, seluruh film ini benar-benar luar biasa. Faktanya, film ini benar-benar hebat. Alur ceritanya sangat menarik, aktingnya sangat baik, dan soundtrack-nya begitu mengharukan.Nilai parameter 0.0: Film ini bagus. Alur ceritanya bagus, aktingnya bagus, dan musiknya bagus. Secara keseluruhan, seluruh film ini sangat bagus. Faktanya, film ini benar-benar hebat. Alur ceritanya sangat bagus, aktingnya juga sangat baik, dan musiknya sama luar biasanya.Nilai parameter -2.0: Film ini bagus. Alur ceritanya bagus, aktingnya bagus, dan musiknya bagus. Secara keseluruhan, seluruh film ini bagus. Faktanya, film ini benar-benar bagus. Alur ceritanya sangat bagus, aktingnya sangat bagus, dan musiknya sangat bagus. Tidak disarankan mengubah nilai presence_penalty default model QVQ.response_format object (Opsional) Nilai default adalah {"type": "text"}Format konten yang dikembalikan. Nilai yang valid:
Dokumentasi terkait: Output terstruktur. Jika Anda menentukan
Properti type string(Wajib)Format konten yang dikembalikan. Nilai yang valid:
object (Opsional)Wajib saat type adalah json_schema. Mendefinisikan struktur JSON yang harus diikuti keluaran model. Dokumentasi terkait: Mendapatkan keluaran dalam format yang ditentukan.
Saat memanggil melalui metode
Properti name string(Wajib)Nama Skema.schemaobject(Wajib)Objek JSON Schema yang menjelaskan struktur keluaran. Gunakan properties untuk mendefinisikan struktur field, required untuk mendeklarasikan daftar field wajib, dan additionalProperties untuk mengontrol apakah field yang tidak didefinisikan dalam Skema diizinkan dalam keluaran (kami menyarankan pengaturan ke false, yaitu hanya mengeluarkan field yang telah didefinisikan). Tipe data yang didukung: string, number, integer, boolean, object, array, enum. Dokumentasi terkait: Panduan konfigurasi.strictboolean (Opsional)Apakah akan secara ketat mengikuti struktur yang didefinisikan oleh schema. Kami menyarankan pengaturan ke true.integer (Opsional, akan ditinggalkan)
Parameter ini akan ditinggalkan. Untuk integrasi baru, gunakan Makna parameter ini bervariasi menurut model, sebagai berikut:
integer (Opsional)Panjang maksimum keluaran model, termasuk rantai-pikiran dan respons model. Saat keluaran model melebihi nilai ini, generasi dihentikan lebih awal dan finish_reason yang dikembalikan adalah length.Untuk nilai default dan maksimum model GLM, lihat tabel pada parameter max_tokens. Untuk model lainnya, nilai default dan maksimum keduanya adalah panjang keluaran maksimum model.Perbedaan dengan max_tokens: max_completion_tokens selalu membatasi keluaran lengkap model (rantai-pikiran + respons); cakupan batas spesifik max_tokens bervariasi tergantung pada model dan pengaturan thinking_budget; lihat deskripsi di atas. Untuk model thinking, kami menyarankan menggunakan max_completion_tokens.Model berikut yang didukung:
Selain model GLM penyediaan langsung ZHIPU yang tercantum dalam tabel di atas, model di atas tidak mencakup model penyediaan langsung pihak ketiga lainnya.
Dapat terdapat perbedaan hingga 10 token antara jumlah token keluaran aktual dan nilai vl_high_resolution_imagesboolean (Opsional) Nilai default: falseUntuk qwen4-max, bahkan jika vl_high_resolution_images=true, max_pixels yang diteruskan secara eksplisit tetap berlaku.Apakah akan menaikkan batas piksel gambar input hingga nilai piksel yang sesuai dengan 16384 token. Dokumentasi terkait: Memproses gambar resolusi tinggi.
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Metode konfigurasinya adalah: extra_body={"vl_high_resolution_images":xxx}.n integer (Opsional) Nilai default: 1Jumlah respons yang akan dihasilkan. Rentang nilainya adalah 1-4. Berguna untuk skenario yang memerlukan beberapa respons kandidat, seperti penulisan kreatif atau naskah iklan.
Hanya Jika Anda meneruskan parameter Menaikkan n meningkatkan konsumsi Token keluaran, tetapi tidak meningkatkan konsumsi Token input.enable_thinking boolean (Opsional)Nilai default untuk kimi-k3.1-pro (diterapkan di Alibaba Cloud Model Studio) adalah true. Anda dapat mengaturnya ke false untuk menonaktifkan thinking, tetapi sangat disarankan untuk tetap mengaktifkannya, karena menonaktifkannya secara signifikan memengaruhi kualitas keluaran.Apakah akan mengaktifkan mode thinking saat menggunakan model hybrid-thinking (yang mungkin atau mungkin tidak berpikir sebelum membalas). Berlaku untuk model Qwen3.8, Qwen3.7, Qwen3.6, Qwen3.5, Qwen3, Qwen3.8-Omni-Flash, Qwen3-Omni-Flash, dan Qwen3-VL, serta seri DeepSeek-V4.1-Flash, seri DeepSeek-V4-Pro/V4-Flash (penyediaan langsung Alibaba Cloud), seri DeepSeek-V3.2/V3.2-exp/V3.1 (penyediaan langsung Alibaba Cloud, penyediaan langsung SiliconFlow, penyediaan langsung Kuaishou Wanqing), Kimi-K2.7-code (model hanya-thinking), seri Kimi-K2.6/K2.5 (penyediaan langsung Alibaba Cloud, penyediaan langsung Moonshot), dan seri GLM. Seri DeepSeek-V4 mengaktifkan thinking secara default, dan Anda dapat menyesuaikan tingkat penalaran melalui parameter reasoning_effort.Nilai yang valid:
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Konfigurasi: Jika Anda tidak menggunakan SDK OpenAI dan memanggil langsung melalui HTTP (seperti curl),
MiniMax/MiniMax-M3.1-Flash dan MiniMax/MiniMax-M3 yang disediakan langsung oleh Xiyu Technology tidak menggunakan parameter ini; gunakan parameter thinking object (Opsional) Nilai default: {"type":"adaptive"}Mengontrol mode thinking model MiniMax yang disediakan langsung oleh Xiyu Technology.Nilai yang mungkin untuk thinking.type:
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Konfigurasi: reasoning_split boolean (Opsional)Mengontrol di mana konten thinking MiniMax dikembalikan:
extra_body, misalnya extra_body={"reasoning_split": True}.thinking_display string (Opsional)qwen4-max: "summarized". Ringkasan dan enkripsi rantai-pikiran.Secara default, rantai-pikiran lengkap dikembalikan. Setelah fitur ini diaktifkan, rantai-pikiran asli tidak lagi dikembalikan dalam teks biasa; sebagai gantinya, ringkasan dan ciphertext lengkap dikembalikan. Ringkasan untuk ditampilkan, dan ciphertext untuk memulihkan thinking historis.preserve_thinking boolean (Opsional) Nilai default: falseqwen4-max: nilai default true.Apakah akan menggabungkan reasoning_content pesan asisten dalam riwayat percakapan ke input model. Berlaku untuk skenario saat model perlu merujuk proses thinking historis.kimi-k3.1-pro dan kimi-k3 (diterapkan di Alibaba Cloud Model Studio) secara default mempertahankan reasoning_content historis yang diteruskan klien. Disarankan meneruskan kembali pesan asisten historis lengkap beserta reasoning_content-nya dalam messages.kimi/kimi-k3.1-pro dan kimi/kimi-k3.1-pro-highspeed mendukung parameter ini, dan nonaktif secara default.Saat model perlu merujuk thinking dari putaran sebelumnya, letakkan dalam field reasoning_content pesan asisten historis dan teruskan kembali dengan messages. Untuk penggunaannya, lihat Meneruskan proses thinking.Saat ini didukung: qwen4-max, qwen3.8-max, qwen3.8-max-0902, qwen3.8-flash (aktif secara default), qwen3.8-omni-flash (aktif secara default), qwen3.7-max, qwen3.7-max-2026-05-20 dan snapshot yang lebih baru, qwen3.7-plus, qwen3.7-plus-2026-05-26, qwen3.6-plus, qwen3.6-plus-2026-04-02, qwen3.7-flash, qwen3.7-flash-2026-07-15, qwen3.6-flash, qwen3.6-flash-2026-04-16, kimi-k2.6 (diterapkan di Alibaba Cloud Model Studio), kimi-k2.7-code (diterapkan di Alibaba Cloud Model Studio, aktif secara default), kimi/kimi-k2.7-code-highspeed (penyediaan langsung Moonshot, aktif secara default), dan kimi/kimi-k2.7-code (penyediaan langsung Moonshot, aktif secara default).Penting: Saat menggunakan qwen4-max, qwen3.8-max/qwen3.8-flash, preserve_thinking defaultnya true, dan Anda harus meneruskan kembali seluruh reasoning_content dari percakapan historis secara lengkap. Penggabungan reasoning_content ke dalam field content dan meneruskannya kembali tidak didukung.
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Metode konfigurasinya adalah: thinking_budget integer (Opsional)qwen4-max: nilai default 131072.Jumlah token maksimum untuk proses thinking. Berlaku untuk qwen4-max, qwen3.8-max, qwen3.8-max-0902, qwen3.8-flash, qwen3.8-2.4t-a95b, qwen3.8-27b, serta model seri Qwen3.7, Qwen3.6, Qwen3.5, Qwen3-VL, Qwen3, GLM (penyediaan langsung Alibaba Cloud), dan Kimi (penyediaan langsung Alibaba Cloud), di antaranya kimi-k3.1-pro dan kimi-k3 tidak mendukung parameter ini. Untuk informasi selengkapnya, lihat Batasi panjang thinking.Model lain: Nilai default untuk model di atas adalah panjang rantai-pikiran maksimum model. Untuk informasi selengkapnya, lihat: Models
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Metode konfigurasinya adalah: use_multichannel boolean (Opsional)Mengontrol apakah akan mengurai informasi spasial dalam audio multichannel. Berlaku untuk input audio qwen3.8-omni-flash, defaultnya false, dan semua audio diurai sebagai mono. Saat diatur ke true dan inputnya adalah audio dua-kanal (kiri dan kanan) atau empat-kanal (FOA, urutan WYZX), informasi audio spasial diurai. Dalam permintaan HTTP, letakkan di tingkat teratas badan permintaan; saat menggunakan SDK Python OpenAI, teruskan melalui extra_body={"use_multichannel": True}.reasoning_effort string (Opsional)qwen4-maxNilai default: reasoning_effort=high.
qwen4-max tidak mendukung pengaturan reasoning_effort dan thinking_budget secara bersamaan. thinking_budget harus berupa integer positif dan tidak dapat diatur ke 0.Saat hanya thinking_budget yang diatur, tingkat thinking ditentukan menurut tabel berikut, dan nilai anggaran yang diteruskan dipertahankan.
high dan 131072 digunakan.Mengontrol tingkat upaya penalaran model; model yang berbeda mendukung nilai opsional dan nilai default yang berbeda.kimi-k3.1-pro (diterapkan di Alibaba Cloud Model Studio) (nilai default adalah max)
max)Nilai opsional, dari upaya penalaran terendah hingga tertinggi, adalah low, medium, high, xhigh, dan max. Model selalu mengaktifkan thinking; menetapkan none mengembalikan error 400.Seri DeepSeek-V4, GLM (nilai default adalah high)Nilai yang valid:
max, hanya max yang didukung)Nilai yang valid:
maxNilai yang valid:
enable_thinking hanya mendukung true; meneruskan false akan menyebabkan permintaan API gagal. kimi-k3 mendukung penerusan false untuk menonaktifkan thinking.Untuk model deepseek-v4-flash-0731 dan deepseek-v4-pro-0813: nilai default adalahhighNilai yang valid:
medium dipetakan ke high, dan xhigh dipetakan ke high.Untuk model deepseek-v4.1-flash: nilai default adalahhighNilai yang valid:
minimal dipetakan ke low, medium dan xhigh dipetakan ke high, dan ultra dipetakan ke max.qwen3.8-max, qwen3.8-max-0902, qwen3.8-flash, qwen3.8-2.4t-a95b, qwen3.8-27b: nilai default adalahxhighNilai yang valid:
max dipetakan ke xhigh, high dipetakan ke xhigh, minimal dipetakan ke low, dan none dipetakan ke enable_thinking=False.Menetapkan nilai selain nilai valid dan nilai terpetakan di atas akan menyebabkan error.Penting: qwen3.8-max, qwen3.8-max-0902, qwen3.8-flash, qwen3.8-2.4t-a95b, dan qwen3.8-27b tidak mendukung pengaturan reasoning_effort dan thinking_budget secara bersamaan; menetapkan keduanya akan menyebabkan error. Namun, keduanya dapat saling dikonversi:
qwen3.8-omni-flash mengaktifkan thinking secara default, dan reasoning_effort defaultnya xhigh. reasoning_effort pada Chat Completions menerima none, minimal, low, medium, high, xhigh, dan max, dan tidak dapat diatur bersama thinking_budget. Untuk lokasi parameter dan contoh, lihat Qwen3.8 Omni.Anda dapat langsung memilih dari tiga tingkat upaya thinking: low, medium, dan xhigh. Di antara nilai kompatibel, minimal dipetakan ke low, high dan max dipetakan ke xhigh, dan none berarti menonaktifkan thinking.tool_stream boolean (Opsional) Nilai default adalah falseHanya berlaku saat stream=true. Saat ini hanya didukung oleh seri Qwen dan GLM.Daftar dukungan seri Qwen:
stream=true diaktifkan. Alat kompleks mengacu pada alat yang definisinya berisi parameter bertipe array atau object.
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Konfigurasinya adalah: enable_code_interpreter boolean (Opsional) Nilai default adalah falseApakah akan mengaktifkan fitur interpreter kode. Dokumentasi terkait: Interpreter kodeNilai yang valid:
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Konfigurasinya adalah: seedinteger (Opsional)Seed acak. Digunakan untuk memastikan hasil generasi dapat direproduksi dengan input dan parameter yang sama. Jika seed yang sama diteruskan dalam pemanggilan dan parameter lain tetap tidak berubah, model akan mengembalikan hasil yang sama sebisa mungkin.Rentang nilai: [0,2 31 −1].
Nilai default seed Nilai default untuk semua model lainnya adalah 1234. boolean (Opsional) Nilai default: falseApakah akan mengembalikan probabilitas log token keluaran. Nilai yang valid:
Konten yang dihasilkan selama fase thinking (
Model yang didukung
integer (Opsional) Nilai default: 0Menentukan jumlah token kandidat dengan probabilitas model tertinggi yang dikembalikan pada setiap langkah generasi.Rentang nilai: [0,5]Hanya berlaku saat logprobs adalah true.stopstring or array(Opsional)Digunakan untuk menentukan stop word. Saat string atau token_id yang ditentukan oleh stop muncul dalam teks yang dihasilkan model, generasi akan segera dihentikan.
MiniMax/MiniMax-M3.1-Flash tidak mendukung parameter ini. Keluaran tidak akan dipotong pada stop word yang ditentukan; permintaan mungkin tetap berhasil dan mengembalikan Anda dapat meneruskan kata sensitif untuk mengontrol keluaran model.Saat stop adalah array,tools array(Opsional)Array yang berisi satu atau lebih objek alat untuk dipanggil model dalam Function Calling. Dokumentasi terkait: Function CallingSaat tools diatur dan model menentukan bahwa alat perlu dipanggil, respons mengembalikan informasi alat melalui tool_calls.
Properti type string(Wajib)Jenis alat. Saat ini, hanya function yang didukung.functionobject(Wajib)
Properti name string(Wajib)Nama alat. Hanya huruf, digit, garis bawah (_), dan tanda hubung (-) yang diizinkan, dengan maksimum 64 token.descriptionstring(Wajib)Deskripsi alat, yang membantu model menentukan kapan dan bagaimana memanggil alat.parametersobject (Opsional) Nilai default: {}Deskripsi parameter alat, yang harus berupa JSON Schema yang valid. Untuk deskripsi JSON Schema, lihat tautan. Jika parameter parameters kosong, berarti alat tidak memiliki parameter input (misalnya, alat kueri waktu).
Untuk meningkatkan akurasi pemanggilan alat, kami menyarankan meneruskan string or object (Opsional) Nilai default: autoKebijakan pemilihan alat. Jika Anda perlu memaksa perilaku pemanggilan alat tertentu untuk jenis pertanyaan tertentu (misalnya, selalu menggunakan alat tertentu atau menonaktifkan semua alat), Anda dapat mengatur parameter ini.MiniMax/MiniMax-M3.1-Flash hanya mendukung deepseek-v4.1-flash-1017 mendukung pengaturan tool_choice ke auto, none, required, atau nama fungsi yang ditentukan.Nilai yang valid:
boolean (Opsional) Nilai default: trueApakah akan mengaktifkan pemanggilan alat paralel. Untuk informasi selengkapnya, lihat Pemanggilan alat paralelMiniMax/MiniMax-M3.1-Flash dan kimi-k3 tidak mendukung pengontrolan paralelisme pemanggilan alat melalui parameter ini. Pengaturan ke kimi/kimi-k3.1-pro dan kimi/kimi-k3.1-pro-highspeed tidak mendukung parameter ini.Nilai yang valid:
boolean (Opsional) Nilai default: falseApakah akan mengaktifkan pencarian web. Parameter ini didukung oleh kimi-k3.1-pro (diterapkan di Alibaba Cloud Model Studio) dan tersedia di Beijing, Singapura, AS (Virginia), Jerman (Frankfurt), Jepang (Tokyo), dan Hong Kong (Tiongkok). Untuk informasi selengkapnya, lihat Pencarian webNilai yang valid:
Mengaktifkan fitur pencarian web dapat meningkatkan konsumsi token.
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Konfigurasinya adalah: search_optionsobject (Opsional)Kebijakan pencarian web. Untuk informasi selengkapnya, lihat Pencarian web
Properti forced_search boolean (Opsional) Nilai default: falseApakah akan memaksa pencarian web. Parameter ini hanya berlaku saat enable_search adalah true.Nilai yang valid:
string (Opsional) Nilai default: turboStrategi skala pencarian, yang hanya berlaku saat enable_search adalah true.Saat pencarian web diaktifkan untuk qwen3.8-omni-flash, Anda harus mengatur parameter ini ke agent.Nilai yang valid:
enable_search adalah true.Nilai yang valid:
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Konfigurasinya adalah: include_tool_usage boolean (Opsional) Nilai default adalah falseApakah akan mengembalikan statistik pemanggilan pencarian web dalam usage respons.Nilai yang valid:
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Konfigurasinya adalah: X-DashScope-DataInspectionstring (Opsional)Berdasarkan kemampuan keamanan konten Qwen API, apakah akan mengidentifikasi lebih lanjut informasi pelanggaran dalam konten input dan output. Nilai yang valid:
-H "X-DashScope-DataInspection: {\"input\": \"cip\", \"output\": \"cip\"}";Saat memanggil melalui SDK Python, konfigurasikan melalui extra_headers: extra_headers={'X-DashScope-DataInspection': '{"input":"cip","output":"cip"}'}.Untuk penggunaan terperinci, lihat Pagar pengaman AI input dan output; jika Anda tidak ingin mengubah kode pemanggilan, Anda dapat mengaktifkan pagar pengaman melalui sakelar tingkat ruang kerja.Tidak didukung saat dikonfigurasi melalui SDK Node.js.skill array (Opsional)Parameter skill, digunakan untuk mengaktifkan kemampuan generasi tertentu (seperti generasi PPT). Hanya model qwen-doc-turbo yang mendukungnya. Untuk penggunaan terperinci, lihat Membuat PPT.
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Konfigurasinya adalah: Saat menggunakan skill, stream harus diatur ke true.
Properti type string(Wajib)Jenis skill. Saat ini didukung:
string (Opsional)Mode generasi PPT. Nilai yang valid:
string (Opsional)ID templat PPT. Digunakan bersama saat mode adalah general atau mode tidak diatur. Nilai yang valid:
boolean (Opsional) Nilai default adalah false.Mengontrol apakah reasoning_content (proses thinking) dari putaran historis disertakan sebagai input konteks ke model dalam percakapan multi-putaran. Hanya model seri GLM glm-5.3, glm-5.2, glm-5.1, dan glm-5 yang mendukung parameter ini. Nilai defaultnya adalah true untuk glm-5.3, dan false untuk model lainnya.
Parameter ini bukan parameter standar OpenAI. Saat memanggil melalui SDK Python, letakkan di objek extra_body. Metode konfigurasinya adalah:
|
Python |
Objek respons Chat (Non-Stream)idstringPengenal unik untuk pemanggilan ini.choicesarrayArray konten yang dihasilkan oleh model.
Properti finish_reason stringAlasan model berhenti menghasilkan.Ada tiga kasus:
integerIndeks objek saat ini dalam array choices.logprobsobjectInformasi probabilitas token yang dikeluarkan model.
Properti content arrayArray yang berisi setiap token dan log probabilitasnya.
Properti token stringTeks Token saat ini.bytes arrayDaftar byte UTF-8 mentah Token saat ini, digunakan untuk merekonstruksi konten keluaran secara presisi (misalnya, emoji atau karakter Tionghoa).logprob floatLog probabilitas Token saat ini. Nilai kembalian null menunjukkan probabilitas yang sangat rendah.top_logprobs arrayToken kandidat yang paling mungkin pada posisi Token saat ini, dengan jumlah sesuai parameter permintaan top_logprobs. Setiap elemen berisi:
Properti token stringTeks Token kandidat.bytes arrayDaftar byte UTF-8 mentah Token saat ini, digunakan untuk merekonstruksi konten keluaran secara presisi (misalnya, emoji atau karakter Tionghoa).logprob floatLog probabilitas Token kandidat ini. Nilai kembalian null menunjukkan probabilitas yang sangat rendah.objectPesan yang dihasilkan oleh model.
Properti content stringKonten balasan model.encrypted_content stringqwen4-max, thinking_display="summarized": Parameter pengaktifan harus diteruskan pada setiap putaran. Klien hanya dapat mengembalikan ciphertext apa adanya; tidak dapat membaca, memotong, mengodekan ulang, mengubah, atau menggabungkan ciphertext antar beberapa putaran. Ringkasan tidak dapat menggantikan rantai-pikiran historis. Untuk informasi selengkapnya, lihat Ringkasan dan enkripsi rantai-pikiran.reasoning_content stringKonten rantai-pikiran model.refusal stringParameter ini saat ini tetap null.role stringPeran pesan, tetap assistant.audio objectParameter ini saat ini tetap null.function_call (akan ditinggalkan) objectNilai ini tetap null. Lihat parameter tool_calls.tool_calls arrayInformasi alat dan parameter input yang dihasilkan model setelah Function Calling dimulai.
Properti id stringPengenal unik respons alat ini.type stringJenis alat. Saat ini hanya function yang didukung.function objectInformasi alat.
Properti name stringNama alat.arguments stringInformasi parameter input, sebagai string berformat JSON.Karena respons model besar memiliki randomness bawaan, informasi parameter keluaran mungkin tidak sesuai dengan signature fungsi. Validasi parameter sebelum memanggil integerIndeks alat saat ini dalam array tool_calls.integerTimestamp Unix (dalam detik) saat permintaan dibuat.modelstringModel yang digunakan untuk permintaan ini.object stringSelalu chat.completion.service_tier stringBernilai null untuk pemanggilan pay-as-you-go; saat memanggil dengan kode model khusus throughput yang dipesan, tingkat performa dikembalikan (ptu_default / ptu_fast). Untuk informasi selengkapnya, lihat Ikhtisar reservasi throughput.system_fingerprintstringParameter ini saat ini tetap null.usage objectInformasi konsumsi Token untuk permintaan ini.
Properti completion_tokens integerJumlah Token yang dihasilkan oleh model.prompt_tokens integerJumlah Token input. Catatan tambahantotal_tokens integerJumlah total Token yang dikonsumsi, yaitu jumlah dari prompt_tokens dan completion_tokens.completion_tokens_details object (Opsional)Rincian terperinci Token keluaran. Beberapa model mengembalikan field ini. text_tokens mencakup reasoning_tokens—reasoning_tokens adalah subset dari text_tokens yang sesuai dengan proses thinking, dan hanya text_tokens dikurangi reasoning_tokens yang memberikan jumlah Token dalam balasan akhir yang terlihat. Field ini biasanya dikembalikan hanya saat model mengeluarkan proses thinking; saat thinking tidak diaktifkan, bisa bernilai null atau tidak dikembalikan.
Properti audio_tokens integer (Opsional)Jumlah token audio dalam keluaran.reasoning_tokens integer (Opsional)Jumlah token proses thinking, yang merupakan subset dari text_tokens.text_tokens integer (Opsional)Jumlah token teks keluaran, yang sudah mencakup reasoning_tokens.objectKlasifikasi terperinci token input.
Properti audio_tokens integerParameter ini saat ini tetap null.cached_tokens integerJumlah token cache hit. Untuk informasi selengkapnya tentang Context Cache, lihat Context Cache.text_tokens integerJumlah token teks input.image_tokens integerJumlah token gambar input.video_tokens integerJumlah token untuk file video atau daftar gambar input.cache_creation objectInformasi pembuatan Cache eksplisit.
Properti ephemeral_5m_input_tokens integerJumlah token yang digunakan untuk membuat cache eksplisit.integerJumlah token yang digunakan untuk membuat cache eksplisit.cache_type stringSaat Cache eksplisit digunakan, nilai parameternya ephemeral; jika tidak, parameter ini tidak ada.
Properti (Qwen4) Untuk informasi selengkapnya, lihat Cache eksplisit (Qwen4).cached_tokens integerJumlah token cache hit. Untuk informasi selengkapnya tentang Context Cache, lihat Context Cache.text_tokens integerJumlah token teks input.image_tokens integerJumlah token gambar input.video_tokens integerJumlah token untuk file video atau daftar gambar input.cache_write_tokens integerJumlah token input untuk pembuatan cache.cache_creation_input_tokens integerSama dengan cache_write_tokens; jangan dihitung dua kali saat mengagregasi statistik.cache_type stringephemeralcache_creation objectDetail pembuatan cache berdasarkan TTL. Jumlah token dari dua TTL tersebut sama dengan jumlah token yang digunakan untuk membuat cache dalam permintaan ini.
Properti ephemeral_5m_input_tokens integerJumlah token untuk pembuatan cache 5 menit.ephemeral_1h_input_tokens integerJumlah token untuk pembuatan cache 1 jam.object (Opsional)Statistik penggunaan pencarian web. Hanya dikembalikan saat include_tool_usage bernilai true dalam permintaan dan pencarian web benar-benar terpicu dalam permintaan ini.
Properti search object (Opsional)Statistik penggunaan pencarian web. Dikembalikan saat pencarian web diaktifkan dan pengambilan benar-benar terpicu.
Properti count integerJumlah kali pencarian web terpicu dalam permintaan ini. Saat strategi pencarian agent digunakan, model dapat melakukan beberapa putaran pengambilan, sehingga nilai ini bisa lebih besar dari 1.Nilai ini ditetapkan pada tahap penentuan intent; tetap dihitung meskipun rate limiting terpicu atau pengambilan tidak mengembalikan hasil. Ini tidak menunjukkan bahwa pengambilan benar-benar selesai, dan tidak boleh digunakan sebagai dasar penagihan atau rekonsiliasi. Untuk informasi selengkapnya, lihat Ketidaksesuaian antara jumlah tagihan dan field count.strategy stringStrategi pencarian yang benar-benar digunakan untuk pencarian web ini, konsisten dengan nilai search_options.search_strategy dalam permintaan, seperti turbo, max, dan agent. |
Contoh respons berikut dari qwen3.8-max, digunakan untuk menjelaskan field respons. |
Objek potongan respons Chat (keluaran streaming)idstringPengenal unik untuk pemanggilan ini. Setiap objek potongan memiliki id yang sama.choicesarrayArray konten yang dihasilkan oleh model, dapat berisi satu atau lebih objek. Pada potongan terakhir yang digunakan untuk mengembalikan informasi penggunaan Token, choices adalah array kosong.
Properti delta objectObjek inkremental dari permintaan.
Properti content stringKonten pesan inkremental.encrypted_content stringqwen4-max, thinking_display="summarized": Parameter pengaktifan harus diteruskan pada setiap putaran. Klien hanya dapat mengembalikan ciphertext apa adanya, dan tidak boleh membaca, memotong, mengodekan ulang, mengubah, atau menggabungkan ciphertext antar beberapa putaran. Ringkasan tidak dapat menggantikan rantai-pikiran historis. Ringkasan dan enkripsi rantai-pikiran. Ciphertext dikembalikan dalam frame data independen dan tidak boleh digabungkan dengan frame lain atau ciphertext multi-putaran.reasoning_content stringKonten rantai-pikiran inkremental.function_call objectNilai ini defaultnya null. Untuk informasi selengkapnya, lihat parameter tool_calls.audioobjectRespons yang dihasilkan saat menggunakan model Qwen-Omni.
Properti data stringData audio Base64-encoded inkremental.expires_at integerTimestamp saat permintaan dibuat.objectParameter ini saat ini tetap null.role stringPeran objek pesan inkremental, yang hanya bernilai pada potongan pertama.tool_calls arrayInformasi alat dan parameter input yang dihasilkan model setelah Function Calling dimulai.
Properti index integerIndeks alat saat ini dalam array tool_calls.id stringPengenal unik respons alat ini.function objectInformasi tentang alat yang dipanggil.
Properti arguments stringInformasi parameter input inkremental. arguments dari semua potongan, saat digabungkan, membentuk parameter input lengkap.Karena respons model besar melibatkan randomness, informasi parameter input yang dikeluarkan mungkin tidak sesuai dengan signature fungsi. Validasi keabsahan parameter sebelum memanggil.name stringNama alat, yang hanya bernilai pada potongan pertama.stringJenis alat. Saat ini hanya function yang didukung.stringAlasan model berhenti menghasilkan. Ada empat kasus:
integerIndeks respons saat ini dalam array choices. Saat parameter input n lebih besar dari 1, gunakan parameter ini untuk merakit konten lengkap yang sesuai dengan setiap respons berbeda.logprobsobjectInformasi probabilitas objek saat ini.
Properti content arrayArray token dengan informasi log probabilitas.
Properti token stringToken saat ini.bytes arrayDaftar byte UTF-8 mentah token saat ini, digunakan untuk merekonstruksi konten keluaran secara akurat. Membantu saat memproses emoji dan karakter Tionghoa.logprob floatLog probabilitas token saat ini. Nilai kembalian null menunjukkan probabilitas yang sangat rendah.top_logprobs arrayToken yang paling mungkin pada posisi token saat ini beserta log probabilitasnya. Jumlah elemen konsisten dengan parameter input top_logprobs.
Properti token stringToken saat ini.bytes arrayDaftar byte UTF-8 mentah token saat ini, digunakan untuk merekonstruksi konten keluaran secara akurat. Membantu saat memproses emoji dan karakter Tionghoa.logprob floatLog probabilitas token saat ini. Nilai kembalian null menunjukkan probabilitas yang sangat rendah.integerTimestamp saat permintaan ini dibuat. Setiap potongan memiliki timestamp yang sama.modelstringModel yang digunakan untuk permintaan ini.object stringSelalu chat.completion.chunk.service_tier stringParameter ini saat ini tetap null.system_fingerprintstringParameter ini saat ini tetap null.usage objectToken yang dikonsumsi oleh permintaan ini. Dikembalikan pada potongan terakhir.
Properti completion_tokens integerJumlah Token yang dihasilkan oleh model.prompt_tokens integerJumlah token input.total_tokens integerJumlah total token, yaitu jumlah dari prompt_tokens dan completion_tokens.completion_tokens_details object (Opsional)Detail token keluaran. Beberapa model mengembalikan field ini. Di antaranya, text_tokens mencakup reasoning_tokens—reasoning_tokens adalah subset dari text_tokens yang sesuai dengan proses thinking, dan text_tokens dikurangi reasoning_tokens adalah jumlah token dalam respons akhir yang terlihat. Field ini biasanya dikembalikan hanya saat model mengeluarkan proses thinking; saat thinking tidak diaktifkan, bisa bernilai null atau tidak dikembalikan.
Properti audio_tokens integer (Opsional)Jumlah token audio dalam keluaran.reasoning_tokens integer (Opsional)Jumlah token proses thinking, yang merupakan subset dari text_tokens.text_tokensinteger (Opsional)Jumlah token teks keluaran, yang sudah mencakup reasoning_tokens.objectKlasifikasi terperinci token input.
Properti audio_tokens integerJumlah token audio input.Jumlah token audio dalam file video dikembalikan melalui parameter ini.text_tokens integerJumlah token teks input.video_tokens integerJumlah token video input (sebagai daftar gambar atau file video).image_tokens integerJumlah token gambar input.cached_tokens integerJumlah token yang mengenai cache. Untuk informasi selengkapnya tentang Context Cache, lihat Context Cache.cache_creation objectInformasi pembuatan Cache eksplisit.
Properti ephemeral_5m_input_tokens integerJumlah token yang digunakan untuk membuat cache eksplisit.integerJumlah token yang digunakan untuk membuat cache eksplisit.cache_type stringJenis cache, tetap ephemeral.
Properti (Qwen4) Untuk informasi selengkapnya, lihat Cache eksplisit (Qwen4).text_tokens integerJumlah token teks input.video_tokens integerJumlah token video input (sebagai daftar gambar atau file video).image_tokens integerJumlah token gambar input.cached_tokens integerJumlah token yang mengenai cache. Untuk informasi selengkapnya tentang Context Cache, lihat Context Cache.cache_write_tokens integerJumlah token input untuk pembuatan cache.cache_creation_input_tokens integerSama dengan cache_write_tokens; jangan dihitung dua kali saat mengagregasi statistik.cache_type stringephemeralcache_creation objectDetail pembuatan cache berdasarkan TTL. Jumlah token dari dua TTL tersebut sama dengan jumlah token yang digunakan untuk membuat cache dalam permintaan ini.
Properti ephemeral_5m_input_tokens integerJumlah token untuk pembuatan cache 5 menit.ephemeral_1h_input_tokens integerJumlah token untuk pembuatan cache 1 jam.object (Opsional)Statistik pemanggilan pencarian web. Hanya dikembalikan saat include_tool_usage bernilai true dalam permintaan dan permintaan ini benar-benar memicu pencarian web, dan ditampilkan bersama usage pada potongan terakhir.
Properti search object (Opsional)Statistik penggunaan pencarian web. Dikembalikan saat pencarian web diaktifkan dan pengambilan benar-benar terpicu.
Properti count integerJumlah kali pencarian web terpicu dalam permintaan ini. Saat strategi pencarian agent digunakan, model dapat melakukan beberapa putaran pengambilan, sehingga nilai ini bisa lebih besar dari 1.Nilai ini ditetapkan pada tahap penentuan intent; tetap dihitung meskipun rate limiting terpicu atau pengambilan tidak mengembalikan hasil. Ini tidak menunjukkan bahwa pengambilan benar-benar selesai, dan tidak boleh digunakan sebagai dasar penagihan atau rekonsiliasi. Untuk informasi selengkapnya, lihat Ketidaksesuaian antara jumlah tagihan dan field count.strategy stringStrategi pencarian yang benar-benar digunakan untuk pencarian web ini, konsisten dengan nilai search_options.search_strategy dalam permintaan, seperti turbo, max, dan agent. |
Respons streaming curl menggunakan format SSE: setiap peristiwa diawali dengan data:, peristiwa dipisahkan oleh baris kosong, dan stream diakhiri dengan data: [DONE]. Berikut menghilangkan potongan perantara yang berulang dan menyimpan peristiwa peran, thinking, isi, akhir, dan penggunaan; SDK mengurai SSE dan tidak mengeluarkan data: dan [DONE]. |