Ana içeriğe atla
POST
/
v1
/
videos
Create a Sora video job
curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper airplane glides across a desk.' \
  --form input_reference='@example-file'
{
  "created_at": 1773296991,
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "model": "sora-2",
  "object": "video",
  "progress": 0,
  "seconds": "4",
  "size": "1280x720",
  "status": "queued"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Metinden veya metin artı tek bir referans görselden yeni bir Sora render işi başlatmak için bu endpoint’i kullanın. API bir video id’sini hemen döndürür ve render işleminin tamamlanmasını beklemez.

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

  • Daha hızlı iterasyon için sora-2, çıktı kalitesinin hızdan daha önemli olduğu durumlarda ise 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

​
Uçtan uca akış

1

Render işini oluştur

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

İş tamamlanana kadar sorgulayın

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

Sonucu indirin veya remix yapın

Render tamamlandığında dosyayı Retrieve Video Content ile alın. Hedefe yönelik bir varyasyon istiyorsanız tamamlanmış sonuç üzerinde Remix Video kullanın.

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

OpenAI, Videos API içinde aynı oluştur -> getir -> indir akışını belgeler. CometAPI üzerinde Sora istek yapısını korursunuz, ancak CometAPI base URL ve anahtarını kullanırsınız. Tamamlanmış 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 a current model from the Models page.

Örnek:

"sora-2"

​
seconds
enum<string>
varsayılan:4

Clip duration in seconds.

Mevcut seçenekler:
4,
8,
12
Örnek:

"4"

​
size
enum<string>
varsayılan:1280x720

Output resolution formatted as width x height.

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
​
id
string
gerekli
​
model
string
gerekli
​
object
string
gerekli
​
progress
integer
gerekli
​
seconds
string
gerekli
​
size
string
gerekli
​
status
string
gerekli