Metin, görsel veya videodan Omni video oluşturun

Metinden videoya, görselden videoya veya videodan videoya görevi oluşturmak için bu beta endpoint’ini kullanın. API hemen bir görev kimliği döndürür; bu nedenle döndürülen id değerini saklayın ve görev nihai bir duruma ulaşana kadar sorgulayın. Giriş moduna uygun istek içerik türünü seçin. Metinden videoya ve görselden videoya kontrollerini multipart/form-data alanları olarak gönderin. Referans video düzenlemesini application/json gövdesi olarak gönderin.

Bir giriş modu seçin

Amaç	İçerik türü	Zorunlu alanlar	İsteğe bağlı alanlar
Metinden videoya	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Görselden videoya	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
Videodan videoya	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

Metinden videoya ve görselden videoya örnekleri model=omni-fast kullanır. Videodan videoya örnekleri model=omni-fast-v2v kullanır. Bir model kimliğinin API anahtarınız için görünür olduğunu doğrulamak amacıyla Kullanılabilir modelleri listeleyin işlemini kullanın.

Referans görseli canlandırın

Görselden videoya için model=omni-fast kullanın ve multipart input_reference alanına bir PNG dosyası yükleyin. Alan, metinden videoya için isteğe bağlı kalır; ancak oluşturulan videoyu bir referans görselin yönlendirmesi gerektiğinde zorunludur. Eklemek istediğiniz harekete odaklanan bir prompt yazın ve sonucun koruması gereken renkleri, şekilleri, özneleri veya kompozisyonu açıkça belirtin. Kod örneği seçicisi, çalışma dizininden reference.png yükleyip görevi oluşturan Shell, Python ve JavaScript örnekleri içerir. Bu istek yapısı, yüklenen bir PNG’yi kapsar. URL girişi, diğer görsel biçimleri, birden fazla referans görseli veya dosya boyutu sınırlarını tanımlamaz.

Referans videoyu düzenleyin

Videodan videoya için yerel bir MP4 dosyasını base64 olarak kodlayın ve kodlanmış baytların başına data:video/mp4;base64, ekleyin. Tam data URL’yi video alanında gönderin. İstenen değişiklikleri prompt içinde açıklayın. Ayrıca sonucun koruması gereken özneleri, nesneleri, kompozisyonu veya hareketi belirtin. Kod örneği seçicisi, çalışma dizininden reference.mp4 okuyan Shell, Python ve JavaScript örnekleri içerir. Bu istek yapısı satır içi bir MP4 data URL’sini kapsar. URL girişi, diğer video kapsayıcı biçimleri veya dosya boyutu sınırlarını tanımlamaz.

Süreyi, oranı ve çözünürlüğü ayarlayın

Omni, oluşturma kararlılığı girdiye ve seçilen rotaya göre değişebileceği için beta olarak işaretlenmiştir. İlk isteği küçük tutun, ardından belirli bir render edilmiş süreye veya kare boyutuna güvenmeden önce tamamlanan videoyu inceleyin.

Ayar	Desteklenen değerler	Varsayılan	Sınır davranışı
`seconds`	Şununla başlayın `4`	Rotaya bağlı	Bunu talep edilen bir süre olarak değerlendirin ve çıktı süresi farklı olabileceğinden tamamlanan MP4’ü doğrulayın.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` dikey çıktı oluşturabilir. `1:1`, yatay olarak render edilirken kabul edilebilir.
`resolution`	`720p` ile başlayın; `1080p` kabul edilebilir	`720p`	Mevcut üretim çıktısı, `720p` istendiğinde bile `1080p` değerine normalize edilebilir.

İstek	Gözlemlenen tamamlanmış kare
`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`

Bu endpoint beta olduğundan, aspect_ratio ve resolution değerlerini oluşturma tercihleri olarak değerlendirin ve nihai piksellere güvenmeden önce indirilen MP4’ü doğrulayın.

Görev akışı

Görevi oluşturun

İsteği, seçilen giriş moduna uygun içerik türüyle gönderin ve döndürülen id değerini saklayın.

Görevi yoklayın

Çağırın Bir Omni videosunu alın status, completed veya failed olana kadar.

Sonucu indirin

Görev completed olduğunda, çağırın Omni video içeriğini alın MP4 dosyasını indirmek için.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer authentication. Use your CometAPI API key.

Gövde

model

string

gerekli

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

Örnek:

"omni-fast"

prompt

string

gerekli

Text prompt that describes the video to generate. For image-to-video, focus on motion and name the reference content that should be preserved.

Örnek:

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

input_reference

file

One PNG reference image uploaded as a multipart file. Optional for text-to-video and required for image-to-video. This contract does not define URL input, other image formats, multiple references, or a file-size limit.

seconds

string

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

Örnek:

"4"

aspect_ratio

enum<string>

varsayılan: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.

Mevcut seçenekler:

16:9,

9:16,

1:1

Örnek:

"16:9"

resolution

string

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

Örnek:

"720p"

Yanıt

200 - application/json

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

string

gerekli

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

Örnek:

"task_example"

object

string

gerekli

Object type. Video tasks return video.

Örnek:

"video"

model

string

gerekli

Model ID used for the task.

Örnek:

"omni-fast"

status

enum<string>

gerekli

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

Mevcut seçenekler:

queued,

in_progress,

completed,

failed,

error

Örnek:

"queued"

progress

integer

gerekli

Task progress as a coarse percentage.

Gerekli aralık: 0 <= x <= 100

Örnek:

0

created_at

integer

gerekli

Task creation time as a Unix timestamp in seconds.

Örnek:

1779938152

task_id

string

Compatibility alias for id when present.

Örnek:

"task_example"

completed_at

integer

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

Örnek:

1779938219

video_url

string

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

Örnek:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Show child attributes

İçerik moderasyonu

API anahtarları

Metin, görsel veya videodan Omni video oluşturun

Bir giriş modu seçin

Referans görseli canlandırın

Referans videoyu düzenleyin

Süreyi, oranı ve çözünürlüğü ayarlayın

Görev akışı

Yetkilendirmeler

Gövde

Yanıt

​Bir giriş modu seçin

​Referans görseli canlandırın

​Referans videoyu düzenleyin

​Süreyi, oranı ve çözünürlüğü ayarlayın

​Görev akışı

Yetkilendirmeler

Gövde

Yanıt

Bir giriş modu seçin

Referans görseli canlandırın

Referans videoyu düzenleyin

Süreyi, oranı ve çözünürlüğü ayarlayın

Görev akışı