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.
/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 dapat terus menggunakan /v1/images/generations, /v1/videos/generations, /v1/videos, /v1/music/generations, /v1/audio/generations, dan /openai/v1/audio/generations. Integrasi baru harus menggunakan rute eksplisit /v1/async-tasks/*-generations di atas.