Referensi penggunaan lama dan pemetaan migrasi 1.x ke 2.0 untuk DashScope Python SDK, untuk proyek yang masih menggunakan versi 1.x.
Halaman ini ditujukan untuk proyek yang masih menggunakan DashScope Python SDK 1.x. Halaman ini menghimpun penggunaan tipikal antarmuka 1.x dalam satu tempat dan menunjukkan kode 2.0 yang setara.
Versi 1.x dikonfigurasi melalui variabel global tingkat modul; versi 2.0 dikonfigurasi melalui argumen konstruktor
Tugas bertahap (1.x
Kontrol bertahap (
Versi 1.x menggunakan kelas callback (
Pengenalan file lokal sekali jalan (1.x
Pada 1.x,
Sintesis sekali jalan menggunakan
Embedding batch (1.x
Pemanggilan aplikasi streaming tetap mempertahankan parameter
Selain nama antarmuka, perhatikan perbedaan perilaku berikut saat migrasi:
Pemetaan migrasi antarmuka
| Kemampuan | Antarmuka 1.x | Antarmuka 2.0 |
|---|---|---|
| Generasi teks | Generation.call / AioGeneration.call | client.chat.completions.create |
| Chat multimodal | MultiModalConversation.call | client.multimodal.chat.create |
| Generasi gambar | ImageSynthesis.call/async_call/fetch/wait | client.images.generate / client.images.jobs.* |
| Generasi video | VideoSynthesis.call/async_call/fetch/wait | client.videos.generate / client.videos.jobs.* |
| Transkripsi file audio | Transcription.async_call/fetch/wait | client.audio.asr.transcribe / client.audio.asr.jobs.* |
| Pengenalan ucapan real-time | Recognition.start/send_audio_frame/stop | client.audio.asr.recognize(...) context manager |
| Sintesis suara | SpeechSynthesizer (tts_v2 callback style) | client.audio.tts.synthesize/stream/connect |
| Embedding teks | TextEmbedding.call / BatchTextEmbedding | client.embeddings.create / client.embeddings.jobs.* |
| Rerank | TextReRank.call | client.rerank.create |
| Aplikasi agen | Application.call | client.apps.completions.create |
| Manajemen file | Files.upload/list/get/delete | client.files.upload/list/get/delete |
| Daftar model | Models.list/get | client.models.list/get |
Konstruksi klien dan autentikasi
Versi 1.x dikonfigurasi melalui variabel global tingkat modul; versi 2.0 dikonfigurasi melalui argumen konstruktor Client (prioritas: konstruktor > dashscope.settings > variabel lingkungan > ~/.dashscope/config.toml).
Generasi teks
Chat multimodal
Generasi gambar
async_call/fetch/wait) dipetakan ke client.images.jobs.create/fetch/wait; penentuan status tugas berubah dari rsp.output.task_status == 'SUCCEEDED' menjadi job.succeeded.
Generasi video
Pada 1.x,
extend_prompt dari VideoSynthesis bernilai default True; pada 2.0 namanya menjadi prompt_extend dan nilai defaultnya ditentukan oleh server. Pemanggilan yang bergantung pada nilai default lama harus meneruskan prompt_extend=True secara eksplisit.Transkripsi file audio
async_call + loop fetch pada versi lama) dipetakan ke client.audio.asr.jobs.create + loop jobs.fetch.
Pengenalan ucapan real-time
Versi 1.x menggunakan kelas callback (Recognition + RecognitionCallback); versi 2.0 menggunakan context manager + iterasi event.
Recognition.call(file)) dipetakan ke for event in client.audio.asr.recognize_file(path, model=...):.
Sintesis suara
Pada 1.x, tts_v2 menerima audio melalui callback; pada 2.0 menggunakan gaya iterasi/sesi.
client.audio.tts.synthesize(text, model=..., voice=...); streaming murni mengiterasi client.audio.tts.stream(text, ...).
Embedding dan rerank
BatchTextEmbedding) dipetakan ke client.embeddings.jobs.create/fetch/wait. TextReRank.call dipetakan ke client.rerank.create, dengan hasil berpindah dari resp.output.results[i] ke resp.results[i].
Pemanggilan aplikasi agen
incremental_output (menentukan bentuk frame); keluaran per frame berpindah dari response.output.text ke partial.text.
Perbedaan perilaku
Selain nama antarmuka, perhatikan perbedaan perilaku berikut saat migrasi:
- Penanganan kesalahan: 1.x memeriksa
status_code/codepada respons; 2.0 secara default melempar keluarga pengecualianDashScopeError(dengane.code/e.status_code/e.request_id/e.message). Untuk perilaku bergaya envelope, konstruksikanClient(raise_on_error=False). - Keluaran streaming:
Generation.call(stream=True)pada 1.x secara default memutar ulang seluruh teks pada setiap frame (incremental_output=Trueuntuk delta); streaming pada 2.0 selalu inkremental. Aplikasi Model Studio (apps.completions) tetap mempertahankan sakelarincremental_output. - Penantian tugas asinkron:
waitpada 1.x menunggu tanpa batas secara default dan mengembalikan respons kesalahan saat waktu habis;jobs.waitpada 2.0 memiliki total anggaran default 24 jam, polling dengan backoff eksponensial, dan melempar pengecualian untuk tugas FAILED. - Struktur respons: 1.x membungkus konten bisnis di bawah field
output(response.output.choices[...]); 2.0 sudah diratakan (response.choices[...]) dengan akses praktis sepertiresp.output_textdanjob.succeeded. - Parameter di luar signature: metode resource 2.0 memiliki signature bernama tertutup; parameter khusus model yang diteruskan pada 1.x harus melalui
parameters={...}(material gambar melaluiextra_input=).
Dokumentasi terkait
- Instalasi dan upgrade: Instal SDK
- Generasi teks: Generasi teks, Streaming output, Percakapan multi-putaran
- Gambar dan video: Generasi gambar, Generasi video
- Suara: Transkripsi file audio, Pengenalan ucapan real-time, Sintesis suara real-time
- Embedding dan rerank: Penyematan, Rerank
- Pemanggilan aplikasi: Pemanggilan Aplikasi