Buat video Omni

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Gunakan endpoint beta ini untuk membuat tugas teks-ke-video atau video-ke-video. API langsung mengembalikan ID tugas, jadi simpan id yang dikembalikan dan lakukan polling pada tugas hingga mencapai status terminal. Pilih jenis konten permintaan yang sesuai dengan mode input. Kirim kontrol teks-ke-video sebagai field multipart/form-data. Kirim pengeditan video referensi sebagai body application/json.

Pilih mode input

Tujuan	Jenis konten	Field wajib	Field opsional
Teks-ke-video	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Video-ke-video	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

Contoh teks-ke-video menggunakan model=omni-fast. Contoh video-ke-video menggunakan model=omni-fast-v2v. Gunakan Daftarkan model yang tersedia untuk mengonfirmasi bahwa ID model terlihat oleh API key Anda.

Edit video referensi

Untuk video-ke-video, enkode file MP4 lokal sebagai base64 dan awali byte yang dienkode dengan data:video/mp4;base64,. Kirim data URL lengkap dalam field video. Jelaskan perubahan yang diminta dalam prompt. Sebutkan juga subjek, objek, komposisi, atau gerakan yang harus dipertahankan oleh hasilnya. Pemilih contoh kode menyertakan contoh Shell, Python, dan JavaScript yang membaca reference.mp4 dari direktori kerja. Bentuk permintaan ini mencakup data URL MP4 inline. Bentuk ini tidak menetapkan input URL, format kontainer video lain, atau batas ukuran file.

Atur durasi, rasio, dan resolusi

Omni ditandai sebagai beta karena stabilitas pembuatan dapat bervariasi menurut input dan rute yang dipilih. Mulailah dengan permintaan kecil, lalu periksa video yang selesai sebelum mengandalkan durasi hasil render atau ukuran frame tertentu.

Pengaturan	Nilai yang didukung	Default	Perilaku batas
`seconds`	Mulai dengan `4`	Bergantung pada rute	Anggap ini sebagai durasi yang diminta dan verifikasi MP4 yang selesai karena durasi output dapat berbeda.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` dapat merender output potret. `1:1` dapat diterima saat merender sebagai lanskap.
`resolution`	Mulai dengan `720p`; `1080p` dapat diterima	`720p`	Output produksi saat ini dapat dinormalisasi menjadi `720p` bahkan ketika `1080p` diminta.

Permintaan	Frame selesai yang diamati
`resolution=720p`, `aspect_ratio=16:9`	`1280x720`
`resolution=720p`, `aspect_ratio=9:16`	`720x1280`
`resolution=720p`, `aspect_ratio=1:1`	`1280x720`
`resolution=1080p`, `aspect_ratio=16:9`	`1280x720`

Karena endpoint ini masih beta, perlakukan aspect_ratio dan resolution sebagai preferensi pembuatan dan verifikasi MP4 yang diunduh sebelum bergantung pada piksel akhir.

Alur tugas

Buat tugas

Kirim permintaan dengan jenis konten untuk mode input yang dipilih dan simpan id yang dikembalikan.

Lakukan polling pada tugas

Panggil Ambil video Omni hingga status bernilai completed atau failed.

Unduh hasil

Saat tugas berstatus completed, panggil Ambil konten video Omni untuk mengunduh file MP4.

Otorisasi

Authorization

string

header

wajib

Bearer authentication. Use your CometAPI API key.

Body

model

string

wajib

Omni model ID for this endpoint. Use omni-fast for text-to-video.

Contoh:

"omni-fast"

prompt

string

wajib

Text prompt that describes the video to generate.

Contoh:

"Ocean waves rolling onto a sandy beach at golden hour"

seconds

string

Requested clip duration in seconds. The completed video can use a different duration.

Contoh:

"4"

aspect_ratio

enum<string>

default:16:9

Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.

Opsi yang tersedia:

16:9,

9:16,

1:1

Contoh:

"16:9"

resolution

string

Output resolution preference. Start with 720p. A request for 1080p can render at 720p.

Contoh:

"720p"

Respons

200 - application/json

Task accepted. Store the returned id and poll GET /v1/videos/{task_id}.

string

wajib

Task ID. Use this value with retrieve and content endpoints.

Contoh:

"task_example"

object

string

wajib

Object type. Video tasks return video.

Contoh:

"video"

model

string

wajib

Model ID used for the task.

Contoh:

"omni-fast"

status

enum<string>

wajib

Task lifecycle status. Poll until the value is completed, failed, or error.

Opsi yang tersedia:

queued,

in_progress,

completed,

failed,

error

Contoh:

"queued"

progress

integer

wajib

Task progress as a coarse percentage.

Rentang yang diperlukan: 0 <= x <= 100

Contoh:

0

created_at

integer

wajib

Task creation time as a Unix timestamp in seconds.

Contoh:

1779938152

task_id

string

Compatibility alias for id when present.

Contoh:

"task_example"

completed_at

integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Contoh:

1779938219

video_url

string

Temporary video delivery URL. This field appears on completed tasks.

Contoh:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Show child attributes

Unduh konten video Vidu

Sebelumnya

Mengambil video Omni

Selanjutnya

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Moderasi konten

Kunci API

Pilih mode input

Edit video referensi

Atur durasi, rasio, dan resolusi

Alur tugas

Otorisasi

Body

Respons

​Pilih mode input

​Edit video referensi

​Atur durasi, rasio, dan resolusi

​Alur tugas

Otorisasi

Body

Respons

Pilih mode input

Edit video referensi

Atur durasi, rasio, dan resolusi

Alur tugas