Entegrasyon Kılavuzları
Hatalar
Fiyatlandırma ve Faturalandırma
Resmi API
Video Oluştur
Metin prompt’larından veya referans görsellerden Sora 2 video üretim görevleri oluşturmak için POST /v1/videos kullanın, ardından sonuçlar için görev kimliğine göre durumu sorgulayın.
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"
}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 isesora-2-prokullanın - İlk isteğiniz için
secondsdeğerini4olarak tutun - Özellikle dikey çıktı gerekmiyorsa
size: 1280x720ile başlayın - En fazla bir referans görsel yükleyin
Uçtan uca akış
İş tamamlanana kadar sorgulayın
Durum
completed veya failed olana kadar Retrieve Video çağrısı yapın.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
Bearer token authentication. Use your CometAPI key.
Gövde
multipart/form-data
Text prompt that describes the video you want to create.
Örnek:
"A paper airplane glides across a desk."
Sora model ID. Choose a current model from the Models page.
Örnek:
"sora-2"
Clip duration in seconds.
Mevcut seçenekler:
4, 8, 12 Örnek:
"4"
Output resolution formatted as width x height.
Mevcut seçenekler:
720x1280, 1280x720, 1024x1792, 1792x1024 Örnek:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.
⌘I
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"
}