Bir Sora 2 videosu oluşturun

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

Bu endpoint’i, metinden veya metin artı bir referans görselden bir Sora render işi başlatmak için kullanın. API hemen bir video kimliği döndürür ve render işleminin bitmesini beklemez.

En küçük kullanışlı işle başlama

Daha hızlı iterasyon için sora-2, hızdan çok çıktı kalitesinin önemli olduğu durumlarda sora-2-pro kullanın
İlk isteğiniz için seconds değerini 4 olarak tutun
Özellikle dikey çıktı gerekmiyorsa size: 1280x720 ile başlayın
En fazla bir referans görsel yükleyin

Süre ve boyut

Ayar	Desteklenen değerler	Varsayılan başlangıç noktası	Sınır davranışı
`seconds`	`4`, `8`, `12`, `16`, `20`	`4`	Diğer değerler Sora video istek yapısının bir parçası değildir.
`size` for `sora-2`	`1280x720`, `720x1280`	`1280x720`	Yatay veya dikey yönlendirme kullanın.
`size` for `sora-2-pro`	`1792x1024`, `1024x1792`, plus the standard Sora sizes	`1792x1024` for landscape Pro output	Daha büyük Pro boyutlarını yalnızca bir Pro model ile kullanın.

Sora, size alanının tam WxH biçiminde olmasını gerektirir. 720p gibi çözünürlük belirteçleri ve 16:9 gibi oran etiketleri, bu endpoint’te geçerli Sora size değerleri değildir.

Uçtan uca akış

Render işini oluşturun

model, prompt, seconds ve size gönderin, ardından dönen id değerini kaydedin.

İş tamamlanana kadar sorgulayın

Durum completed veya failed olana kadar Retrieve Video çağrısı yapın.

Sonucu indirin

Render tamamlandığında, dosyayı Retrieve Video Content ile alın.

Hâlâ geçerli olan Sora davranışı

OpenAI, Videos API içinde aynı create -> retrieve -> download akışını belgeler. CometAPI üzerinde Sora istek yapısını korursunuz, ancak CometAPI temel URL’sini ve anahtarını kullanırsınız. Tamamlanan indirme URL’leri geçicidir; uzun süreli saklama gerekiyorsa tamamlanmış varlıkları kendi depolamanıza kopyalayın.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

multipart/form-data

prompt

string

gerekli

Text prompt that describes the video you want to create.

Örnek:

"A paper airplane glides across a desk."

model

string

varsayılan:sora-2

Sora model ID. Choose an available model from the Models page.

Örnek:

"sora-2"

seconds

enum<string>

varsayılan:4

Clip duration in seconds. Use 4, 8, 12, 16, or 20.

Mevcut seçenekler:

4,

8,

12,

16,

20

Örnek:

"4"

size

enum<string>

varsayılan:1280x720

Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.

Mevcut seçenekler:

720x1280,

1280x720,

1024x1792,

1792x1024

Örnek:

"1280x720"

input_reference

file

Optional reference image uploaded as a file. The image should match the target size you request.

Yanıt

200 - application/json

Video job accepted.

created_at

integer

gerekli

string

gerekli

model

string

gerekli

object

string

gerekli

progress

integer

gerekli

seconds

string

gerekli

size

string

gerekli

status

string

gerekli

Son değiştirilme tarihi 3 Temmuz 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

İçerik moderasyonu

API anahtarları

En küçük kullanışlı işle başlama

Süre ve boyut

Uçtan uca akış

Hâlâ geçerli olan Sora davranışı

Yetkilendirmeler

Gövde

Yanıt

​En küçük kullanışlı işle başlama

​Süre ve boyut

​Uçtan uca akış

​Hâlâ geçerli olan Sora davranışı

Yetkilendirmeler

Gövde

Yanıt

En küçük kullanışlı işle başlama

Süre ve boyut

Uçtan uca akış

Hâlâ geçerli olan Sora davranışı