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/videos

Badan Permintaan

BidangTipeWajibDeskripsi
promptstringYaDeskripsi teks adegan dan pergerakan kamera video yang diinginkan.
modelstringTidakPengenal model video, seperti kling-v4 atau doubao-seedance-2-0-260128.
duration_secondsnumberTidakDurasi video dalam detik (angka positif hingga 300, atau alias duration).
Additional fieldsobjectTidakParameter video tambahan (seperti resolution, aspect_ratio, first_frame_url, last_frame_url) diteruskan tanpa perubahan ke mesin hulu.

Aset Resmi Seedance

POST/v1/seedance/assets
GET/v1/seedance/assets/{asset_id}
  • Pendaftaran aset: Kirim POST /v1/seedance/assets (operationId: seedance_assets.create) dengan JSON yang berisi bidang wajib sourceUrl dan assetType (image atau video), serta displayName opsional.
  • 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, dan cancelled.
  • 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/videos adalah alias media lama dari POST /v1/videos (legacy_media.video.create.alias), mengikuti struktur yang sama.
  • Rute tugas lama: POST /v1/videos/generations menerima muatan format CreateVideoGenerationRequest.
  • Saluran asinkron terpadu: POST /v1/async-tasks/video-generations menyediakan kontrak siklus hidup tugas asinkron standar v4.