Hasilkan Media Asinkron
Buat pekerjaan gambar, video, atau musik dan ambil artefak mereka secara asinkron.
Kirim pekerjaan pembuatan media yang berjalan lama tanpa membuka permintaan inferensi.
POST
/v1/async-tasks/image-generationsBadan Permintaan
| Bidang | Tipe | Wajib | Deskripsi |
|---|---|---|---|
model | string | Tidak | Pengenal model media. Jika dihilangkan, perutean menggunakan perilaku penyedia default yang dikonfigurasi. |
prompt | string | Ya | Deskripsi keluaran yang diinginkan. |
n | integer | Tidak | Jumlah gambar dari 1 hingga 10; defaultnya adalah 1. |
seed | integer | Tidak | Benih deterministik non-negatif jika didukung. |
| Bidang Tambahan | object | Tidak | Dimensi yang didukung penyedia dan kontrol pembuatan. Bidang tingkat atas yang tidak diketahui ditolak; opsi spesifik penyedia berada di bawah provider_options atau parameters. |
Permintaan video menerima duration_seconds positif hingga 300 dan bilangan bulat positif fps hingga 120. Permintaan musik menerima duration_seconds hingga 1.200 dan memerlukan setidaknya salah satu dari prompt, lyrics, atau title.
Siklus Hidup Tugas
- Kirim permintaan pembuatan gambar, video, atau musik.
- Simpan ID tugas yang dikembalikan.
- Lakukan polling pada
GET /v1/async-tasks/{task_id}hingga tugas selesai. - Unduh keluaran melalui URL artefak yang ditandatangani.
URL artefak dibatasi waktu. Simpan aset akhir di penyimpanan Anda sendiri jika diperlukan retensi jangka panjang.
Alias Kompatibilitas
Integrasi yang ada mungkin menggunakan /v1/images/generations, /v1/videos/generations, dan /v1/music/generations. Integrasi baru harus menggunakan rute /v1/async-tasks/*-generations eksplisit di atas.