Skip to main content
POST
cURL
Bir Omni video görevi oluşturmak için bu beta endpoint’i kullanın. API hemen bir görev kimliği döndürür, bu nedenle dönen id değerini saklayın ve görev terminal bir duruma ulaşana kadar görevi yoklayın. Beta POST /v1/videos multipart/form-data kullanır; skaler kontrolleri form alanları olarak iletin.

Bir giriş modu seçin

Bu sayfa için model=omni-fast kullanın.

Süre, oran ve çözünürlük ayarlayın

Omni, üretim kararlılığı girişe ve seçilen rotaya göre değişebildiği için beta olarak işaretlenmiştir. İlk isteği küçük tutun, ardından belirli bir render süresine veya kare boyutuna güvenmeden önce tamamlanan videoyu inceleyin. Bu endpoint beta olduğundan, aspect_ratio ve resolution değerlerini üretim tercihleri olarak değerlendirin ve nihai piksel boyutlarına bağlı kalmadan önce indirilen MP4 dosyasını doğrulayın.

Görev akışı

1

Görevi oluşturun

Multipart form isteğini gönderin ve dönen id değerini saklayın.
2

Görevi yoklayın

status değeri completed veya failed olana kadar Bir Omni videosunu alın çağrısını yapın.
3

Sonucu indirin

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

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer authentication. Use your CometAPI API key.

Gövde

multipart/form-data
model
enum<string>
gerekli

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

Mevcut seçenekler:
omni-fast
Örnek:

"omni-fast"

prompt
string
gerekli

Text prompt that describes the video to generate.

Örnek:

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

seconds
string
varsayılan:4

Requested clip duration in seconds. Start with 4 while this endpoint is beta.

Ö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. 1080p can be accepted but current production output may normalize to 720p.

Örnek:

"720p"

Yanıt

200 - application/json

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

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.