Pembuatan Video dan Manajemen Aset
Buat video dengan model Kling v4 dan Seedance, serta referensikan aset media resmi.
Kirim tugas pembuatan video dan kelola aset media resmi melalui titik akhir video native.
POST
/v1/videosBadan Permintaan
| Bidang | Tipe | Wajib | Deskripsi |
|---|---|---|---|
prompt | string | Ya | Deskripsi teks adegan dan pergerakan kamera video yang diinginkan. |
model | string | Tidak | Pengenal model video, seperti kling-v4 atau doubao-seedance-2-0-260128. |
duration_seconds | number | Tidak | Durasi video dalam detik (angka positif hingga 300, atau alias duration). |
| Additional fields | object | Tidak | Parameter video tambahan (seperti resolution, aspect_ratio, first_frame_url, last_frame_url) diteruskan tanpa perubahan ke mesin hulu. |
Aset Resmi Seedance
POST
/v1/seedance/assetsGET
/v1/seedance/assets/{asset_id}- Pendaftaran aset: Kirim
POST /v1/seedance/assets(operationId: seedance_assets.create) dengan JSON yang berisi bidang wajibsourceUrldanassetType(imageatauvideo), sertadisplayNameopsional. - Referensi URI: Referensikan media terdaftar secara langsung menggunakan
asset://{asset_id}dalam URL bingkai atau parameter lanjutan. - Isolasi penyewa: Aset diisolasi dengan aman ke pustaka aset penyewa saat ini dan diverifikasi terhadap penyimpanan upstream.
Status Tugas dan Pengunduhan
GET
/v1/videos/{task_id}- Polling status: Kueri status tugas melalui
GET /v1/videos/{task_id}(operationId: legacy_media.video.get), mendukung 9 status:queued,submitting,submitted,running,ingesting_artifacts,cancel_requested,completed,failed, dancancelled. - Unduh artefak: Unduh file video biner yang telah selesai melalui
GET /v1/videos/{task_id}/content. - Dukungan Kling v4: Mendukung penuh teks-ke-video, gambar bingkai pertama, dan transisi bingkai akhir.
Alias Kompatibilitas
- Alias media lama:
POST /openai/v1/videosadalah alias media lama dariPOST /v1/videos(legacy_media.video.create.alias), mengikuti struktur yang sama. - Rute tugas lama:
POST /v1/videos/generationsmenerima muatan formatCreateVideoGenerationRequest. - Saluran asinkron terpadu:
POST /v1/async-tasks/video-generationsmenyediakan kontrak siklus hidup tugas asinkron standar v4.