Penjanaan Video dan Pengurusan Aset

Jana video dengan model Kling v4 dan Seedance, serta rujuk aset media yang dibenarkan.

Hantar tugas penjanaan video dan urus aset media yang dibenarkan melalui titik akhir video asli.

POST/v1/videos

Badan Permintaan

MedanJenisDiperlukanPenerangan
promptstringYaPenerangan teks tentang babak dan pergerakan kamera video yang diingini.
modelstringTidakPengecam model video, seperti kling-v4 atau doubao-seedance-2-0-260128.
duration_secondsnumberTidakTempoh video dalam saat (nombor positif sehingga 300, atau alias duration).
Additional fieldsobjectTidakParameter video tambahan (seperti resolution, aspect_ratio, first_frame_url, last_frame_url) dihantar tanpa perubahan ke enjin huluan.

Aset Sah Seedance

POST/v1/seedance/assets
GET/v1/seedance/assets/{asset_id}
  • Pendaftaran aset: Hantar POST /v1/seedance/assets (operationId: seedance_assets.create) dengan JSON yang mengandungi medan wajib sourceUrl dan assetType (image atau video), serta displayName pilihan.
  • Rujukan URI: Rujuk media berdaftar secara langsung menggunakan asset://{asset_id} dalam URL bingkai atau parameter lanjutan.
  • Pengasingan penyewa: Aset diasingkan dengan selamat ke pustaka aset semasa penyewa dan disahkan terhadap storan huluan.

Status Tugas dan Muat Turun

GET/v1/videos/{task_id}
  • Pengundian status: Buat pertanyaan status tugas melalui GET /v1/videos/{task_id} (operationId: legacy_media.video.get), menyokong 9 status: queued, submitting, submitted, running, ingesting_artifacts, cancel_requested, completed, failed, dan cancelled.
  • Muat turun artifak: Muat turun fail video binari yang siap melalui GET /v1/videos/{task_id}/content.
  • Sokongan Kling v4: Menyokong penuh teks-ke-video, gambar bingkai pertama, dan peralihan bingkai akhir.

Alias Keserasian

  • Alias media lama: POST /openai/v1/videos adalah alias media lama bagi POST /v1/videos (legacy_media.video.create.alias), mengikut struktur yang sama.
  • Laluan tugas lama: POST /v1/videos/generations menerima muatan format CreateVideoGenerationRequest.
  • Saluran tak segerak bersepadu: POST /v1/async-tasks/video-generations menyediakan kontrak kitaran hayat tugas tak segerak standard v4.