Model teks ke video PixVerse menghasilkan video yang mulus berdasarkan prompt teks.
PentingDokumen ini hanya berlaku untuk wilayah Singapura. Anda harus menggunakan API key dari wilayah ini.
Aktifkan layanan
- Buka konsol Model Studio, cari PixVerse, temukan kartu model PixVerse, lalu klik Activate Now.
- Di jendela pop-up, konfirmasikan aktivasi dan otorisasi.
Catatan penggunaan
Agar panggilan API berhasil, gunakan model, URL endpoint, dan API key dari wilayah yang sama. Panggilan lintas wilayah akan gagal.
- Pilih model: Pastikan wilayah tempat model Anda berada.
- Pilih URL: Pilih URL endpoint wilayah yang sesuai. URL HTTP maupun DashScope SDK didukung.
- Konfigurasikan API key: Pilih wilayah, dapatkan API key, lalu konfigurasikan API key sebagai variabel lingkungan.
- Instal SDK: Untuk melakukan panggilan menggunakan SDK, instal DashScope SDK.
CatatanContoh kode dalam topik ini berlaku untuk wilayah Singapura.
Panggilan HTTP
Pembuatan video dari teks adalah tugas yang berjalan lama dan biasanya memerlukan 1 hingga 5 menit, sehingga API menggunakan panggilan asinkron. Alurnya terdiri dari dua langkah utama: "Buat tugas -> Lakukan polling hasil". Langkah-langkahnya sebagai berikut:
Langkah 1: Buat tugas untuk mendapatkan ID tugas
Wilayah Singapura: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.
Catatan
- Setelah tugas dibuat, gunakan
task_idyang dikembalikan untuk mengueri hasil.task_idberlaku selama 24 jam. Jangan membuat tugas duplikat. Gunakan polling untuk mengambil hasilnya. - Untuk panduan pemula, lihat Memanggil API dengan Postman atau cURL.
Parameter permintaanHeaderContent-Type Jenis konten permintaan. Harus Authorization Mengautentikasi permintaan dengan API key Model Studio. Contoh: Bearer sk-xxxx. X-DashScope-Async Mengaktifkan pemrosesan asinkron. Permintaan HTTP hanya mendukung panggilan asinkron. Harus PentingJika header permintaan ini tidak ada, kesalahan "current user api does not support synchronous calls" dikembalikan. Isi permintaanmodel Nama model. Nilai yang valid:
input Informasi input dasar, seperti prompt. parameters Parameter pembuatan video, seperti resolusi video, durasi, dan apakah audio dihasilkan. | Teks ke videoModel yang didukung: pixverse/pixverse-v6-t2v. Teks ke video (multi-shot)Model yang didukung: pixverse/pixverse-v6-t2v. Jelaskan adegan multi-shot dalam |
Parameter responsoutput Informasi output tugas. request_id Pengidentifikasi permintaan unik untuk pelacakan dan pemecahan masalah. code Kode kesalahan. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan. message Pesan kesalahan terperinci. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan. | Respons berhasilSimpan Respons kesalahanPembuatan tugas gagal. Lihat Kode kesalahan. |
Langkah 2: Kueri hasil berdasarkan ID tugas
Wilayah Singapura: GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
Catatan
- Rekomendasi polling: Pembuatan video dapat memerlukan beberapa menit. Gunakan mekanisme polling dan lakukan polling hasil dengan interval yang wajar, misalnya setiap 15 detik.
- Alur status tugas: PENDING (dalam antrean) → RUNNING (diproses) → SUCCEEDED (berhasil) / FAILED (gagal).
- Masa berlaku ID tugas:
task_idberlaku selama 24 jam. Setelah itu, kueri akan gagal dan API mengembalikan status tugasUNKNOWN. - Batas RPS: Endpoint kueri memiliki batas default 20 RPS. Untuk kueri berfrekuensi tinggi atau notifikasi peristiwa, konfigurasikan callback tugas asinkron.
- Operasi lainnya: Untuk melakukan kueri batch, membatalkan tugas, atau operasi lain, lihat Mengelola tugas asinkron.
Parameter permintaanHeaderAuthorization Mengautentikasi permintaan dengan API key Model Studio. Contoh: Bearer sk-xxxx. Parameter jalurtask_id ID tugas. | Kueri hasil tugasGanti |
Parameter responsoutput Informasi output tugas. usage Statistik penggunaan output, hanya dihitung untuk tugas yang berhasil. request_id Pengidentifikasi permintaan unik untuk pelacakan dan pemecahan masalah. | Tugas berhasilTugas gagalSaat tugas gagal, Kueri tugas kedaluwarsa
|
Panggilan DashScope SDK
Nama parameter dalam SDK sebagian besar konsisten dengan API HTTP. Struktur parameter disesuaikan dengan fitur setiap bahasa pemrograman.
Karena tugas teks ke video memerlukan waktu lama (biasanya 1 hingga 5 menit), SDK merangkum proses panggilan asinkron HTTP dan mendukung metode panggilan sinkron maupun asinkron.
Waktu aktual yang diperlukan bergantung pada jumlah tugas dalam antrean dan status eksekusi layanan. Harap bersabar menunggu hasilnya.
Panggilan SDK Java
PentingPastikan versi DashScope Java SDK Anda tidak lebih lama dari 2.22.6 sebelum menjalankan kode berikut.
Versi yang lebih lama dapat memicu kesalahan seperti "url error, please check url!". Untuk memperbarui SDK, lihat Instal SDK.
Wilayah Singapura: Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.
Panggilan sinkron
Contoh permintaan
// Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.
// Copyright (c) Alibaba, Inc. and its affiliates.
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;
public class Text2Video {
static {
// Berikut adalah URL untuk wilayah Singapura.
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
}
// Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan API key Model Studio Anda: api_key="sk-xxx"
// Untuk mendapatkan API key, lihat https://www.alibabacloud.com/help/model-studio/get-api-key
public static String apiKey = System.getenv("DASHSCOPE_API_KEY");
/**
* Buat tugas sintesis video dan tunggu hingga tugas selesai.
*/
public static void text2Video() throws ApiException, NoApiKeyException, InputRequiredException {
VideoSynthesis vs = new VideoSynthesis();
VideoSynthesisParam param =
VideoSynthesisParam.builder()
.apiKey(apiKey)
.model("pixverse/pixverse-v6-t2v")
.prompt("In a rainy cyber city, a raccoon walks on a railing. Suddenly, its eyes glow blue, and it transforms into a high-tech drone, flying quickly out of the frame.")
.size("1280*720")
.duration(5)
.audio(true)
.watermark(true)
.seed(12345)
.build();
System.out.println("please wait...");
VideoSynthesisResult result = vs.call(param);
System.out.println(JsonUtils.toJson(result));
}
public static void main(String[] args) {
try {
text2Video();
} catch (ApiException | NoApiKeyException | InputRequiredException e) {
System.out.println(e.getMessage());
}
System.exit(0);
}
}
Contoh respons
Saat ini
video_urltidak kedaluwarsa, tetapi tidak ditujukan untuk penyimpanan jangka panjang. Segera unduh video.
{
"request_id": "bd1109bd-6c63-4e62-8bb8-xxxxxx",
"output": {
"task_id": "72af7c13-dad5-4aaa-b85d-xxxxxx",
"task_status": "SUCCEEDED",
"video_url": "https://media.pixverseai.cn/xxx.mp4",
"orig_prompt": "In a rainy cyber city, a raccoon walks on a railing. Suddenly, its eyes glow blue, and it transforms into a high-tech drone, flying quickly out of the frame.",
"submit_time": "2026-03-20 11:21:13.227",
"scheduled_time": "2026-03-20 11:21:13.252",
"end_time": "2026-03-20 11:21:43.924"
},
"usage": {
"video_count": 1,
"duration": 5.0,
"size": "1280*720",
"input_video_duration": 0.0,
"output_video_duration": 0.0,
"SR": "720"
},
"status_code": 200,
"code": "",
"message": ""
}
Panggilan asinkron
Contoh permintaan
// Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.
// Copyright (c) Alibaba, Inc. and its affiliates.
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisListResult;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.task.AsyncTaskListParam;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;
public class Text2Video {
static {
// Berikut adalah URL untuk wilayah Singapura.
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
}
// Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan API key Model Studio Anda: api_key="sk-xxx"
// Untuk mendapatkan API key, lihat https://www.alibabacloud.com/help/model-studio/get-api-key
public static String apiKey = System.getenv("DASHSCOPE_API_KEY");
/**
* Buat tugas sintesis video dan tunggu hingga tugas selesai.
*/
public static void text2Video() throws ApiException, NoApiKeyException, InputRequiredException {
VideoSynthesis vs = new VideoSynthesis();
VideoSynthesisParam param =
VideoSynthesisParam.builder()
.apiKey(apiKey)
.model("pixverse/pixverse-v6-t2v")
.prompt("In a rainy cyber city, a raccoon walks on a railing. Suddenly, its eyes glow blue, and it transforms into a high-tech drone, flying quickly out of the frame.")
.size("1280*720")
.duration(5)
.audio(true)
.watermark(true)
.seed(12345)
.build();
// Panggilan asinkron
VideoSynthesisResult task = vs.asyncCall(param);
System.out.println(JsonUtils.toJson(task));
System.out.println("please wait...");
// Ambil hasilnya.
VideoSynthesisResult result = vs.wait(task, apiKey);
System.out.println(JsonUtils.toJson(result));
}
// Ambil daftar tugas.
public static void listTask() throws ApiException, NoApiKeyException {
VideoSynthesis is = new VideoSynthesis();
AsyncTaskListParam param = AsyncTaskListParam.builder().build();
param.setApiKey(apiKey);
VideoSynthesisListResult result = is.list(param);
System.out.println(result);
}
// Ambil hasil satu tugas.
public static void fetchTask(String taskId) throws ApiException, NoApiKeyException {
VideoSynthesis is = new VideoSynthesis();
// Jika variabel lingkungan DASHSCOPE_API_KEY telah diatur, apiKey dapat bernilai null.
VideoSynthesisResult result = is.fetch(taskId, apiKey);
System.out.println(result.getOutput());
System.out.println(result.getUsage());
}
public static void main(String[] args) {
try {
text2Video();
} catch (ApiException | NoApiKeyException | InputRequiredException e) {
System.out.println(e.getMessage());
}
System.exit(0);
}
}
Contoh respons
- Contoh respons untuk membuat tugas.
{
"request_id": "9b583f1b-2423-4fac-bb3f-xxxxxx",
"output": {
"task_id": "3944b819-1bbb-4da0-a230-xxxxxx",
"task_status": "PENDING"
},
"status_code": 200,
"code": "",
"message": ""
}
- Contoh respons untuk mengueri hasil tugas
Saat ini
video_urltidak kedaluwarsa, tetapi tidak ditujukan untuk penyimpanan jangka panjang. Segera unduh video.
{
"request_id": "bd1109bd-6c63-4e62-8bb8-xxxxxx",
"output": {
"task_id": "72af7c13-dad5-4aaa-b85d-xxxxxx",
"task_status": "SUCCEEDED",
"video_url": "https://media.pixverseai.cn/xxx.mp4",
"orig_prompt": "In a rainy cyber city, a raccoon walks on a railing. Suddenly, its eyes glow blue, and it transforms into a high-tech drone, flying quickly out of the frame.",
"submit_time": "2026-03-20 11:21:13.227",
"scheduled_time": "2026-03-20 11:21:13.252",
"end_time": "2026-03-20 11:21:43.924"
},
"usage": {
"video_count": 1,
"duration": 5.0,
"size": "1280*720",
"input_video_duration": 0.0,
"output_video_duration": 0.0,
"SR": "720"
},
"status_code": 200,
"code": "",
"message": ""
}
Kode kesalahan
Jika panggilan model gagal dan mengembalikan pesan kesalahan, lihat Kode kesalahan untuk mengatasinya.