Panduan Integrasi
Kesalahan
Harga & Penagihan
API Resmi
Buat Video
Gunakan POST /v1/videos untuk membuat task generasi video Sora 2 dari prompt teks atau gambar referensi, lalu lakukan polling status berdasarkan task ID untuk mendapatkan hasil.
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"
}Gunakan endpoint ini untuk memulai job render Sora baru dari teks, atau dari teks ditambah satu gambar referensi. API segera mengembalikan video id dan tidak menunggu hingga render selesai.
Mulai dengan job berguna yang paling kecil
- Gunakan
sora-2untuk iterasi yang lebih cepat atausora-2-prosaat kualitas output lebih penting daripada kecepatan - Pertahankan
secondspada4untuk permintaan pertama Anda - Mulai dengan
size: 1280x720kecuali Anda memang membutuhkan output portrait - Unggah maksimal satu gambar referensi
Alur end-to-end
Lakukan polling hingga job selesai
Panggil Retrieve Video hingga status menjadi
completed atau failed.Unduh atau remix hasilnya
Ketika render selesai, ambil file dengan Retrieve Video Content. Jika Anda menginginkan variasi yang ditargetkan, gunakan Remix Video pada hasil yang sudah selesai.
Perilaku Sora yang masih berlaku
OpenAI mendokumentasikan alur create -> retrieve -> download yang sama di Videos API. Di CometAPI Anda tetap menggunakan bentuk permintaan Sora, tetapi memakai base URL dan key CometAPI. URL unduhan yang sudah selesai bersifat sementara, jadi salin aset yang telah selesai ke penyimpanan Anda sendiri jika Anda memerlukan retensi jangka panjang.Otorisasi
Bearer token authentication. Use your CometAPI key.
Body
multipart/form-data
Text prompt that describes the video you want to create.
Contoh:
"A paper airplane glides across a desk."
Sora model ID. Choose a current model from the Models page.
Contoh:
"sora-2"
Clip duration in seconds.
Opsi yang tersedia:
4, 8, 12 Contoh:
"4"
Output resolution formatted as width x height.
Opsi yang tersedia:
720x1280, 1280x720, 1024x1792, 1792x1024 Contoh:
"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"
}