Vidu videosu oluştur

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=viduq3-turbo \
  -F 'prompt=An astronaut walks through soft blue fog with a slow cinematic camera move.' \
  -F seconds=1

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

Bu uç noktayı Vidu Q3 metinden videoya veya görüntüden videoya görevi oluşturmak için kullanın. API hemen bir görev kimliği döndürür; bu nedenle döndürülen id değerini kaydedin ve görev terminal bir duruma ulaşana kadar görevi yoklayın. POST /v1/videos multipart/form-data kullanır. Skaler denetimleri form alanları olarak gönderin ve referans görsellerini input_reference dosya alanları olarak belirtin.

Girdi modu seçin

Amaç	Zorunlu alanlar	İsteğe bağlı alanlar
Metinden videoya	`model`, `prompt`	`seconds`, `size`
Görüntüden videoya	`model`, `prompt`, bir `input_reference` dosyası	`seconds`, `size`

API anahtarınızla kullanılabilen bir Vidu model ID’sini doğrulamak için şunu kullanın Kullanılabilir modelleri listele.

Referans görselleri kullan

Görüntüden videoya için bir referans görselini input_reference multipart alanı üzerinden yükleyin. Dosya boyutu en fazla 20 MB olabilir. Görsel, oluşturulan videonun kompozisyonuna ve görünümüne yön verir. Videonun koruması gereken hareketi, kamera davranışını ve ayrıntıları açıklamak için Prompt kullanın.

Süreyi ve boyutu ayarla

Model ID	`seconds`	Varsayılan
`viduq3-turbo`	tam sayı `1`-`16`	`5` saniye, `1280x720`
`viduq3`	tam sayı `1`-`16`	`5` saniye, `1280x720`

size değerini aşağıdaki WxH değerlerinden biri olarak ayarlayın.

Çözünürlük düzeyi	En-boy oranı	`size` (`WxH`)
`540p`	`16:9`	`960x528`
`720p`	`16:9`	`1280x720`
`1080p`	`16:9`	`1920x1080`

Görev akışı

Görevi oluştur

Multipart form isteğini gönderin ve döndürülen id değerini kaydedin.

Görevi yokla

Şunu çağırın: Bir Vidu videosu al status değerinin completed, failed veya error olmasını bekleyin.

Sonucu indir

Görev completed olduğunda şunu çağırın: Vidu video içeriğini al MP4 dosyasını indirmek için.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer authentication. Use your CometAPI API key.

Gövde

multipart/form-data

model

string

gerekli

Vidu Q3 model ID for this route. Choose an available model from the Models page.

Örnek:

"viduq3-turbo"

prompt

string

gerekli

Text prompt that describes the video to generate. For image-to-video, describe the motion and camera behavior that should animate the reference image.

Örnek:

"An astronaut walks through soft blue fog with a slow cinematic camera move."

seconds

string

Requested clip duration in seconds. Use an integer from 1 through 16. Default is 5.

Örnek:

"1"

size

string

Supported WxH size values: 960x528, 1280x720, 1920x1080. Default is 1280x720.

input_reference

file

One reference image file for image-to-video. Omit this field for text-to-video. The file can be up to 20 MB. The image guides the composition and appearance of the generated video.

Yanıt

Task created. 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:

"viduq3-turbo"

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.

Son değiştirilme tarihi 12 Ağustos 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=viduq3-turbo \
  -F 'prompt=An astronaut walks through soft blue fog with a slow cinematic camera move.' \
  -F seconds=1

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

İçerik moderasyonu

API anahtarları

Girdi modu seçin

Referans görselleri kullan

Süreyi ve boyutu ayarla

Görev akışı

Yetkilendirmeler

Gövde

Yanıt

​Girdi modu seçin

​Referans görselleri kullan

​Süreyi ve boyutu ayarla

​Görev akışı

Yetkilendirmeler

Gövde

Yanıt

Girdi modu seçin

Referans görselleri kullan

Süreyi ve boyutu ayarla

Görev akışı