Panduan Integrasi
Kesalahan
Harga & Penagihan
API Resmi
Ambil Video
Gunakan CometAPI GET /v1/videos/ untuk mengambil status video Sora 2, progress, dan metadata seperti durasi, dimensi, timestamp, serta masa berlaku.
GET
/
v1
/
videos
/
{video_id}
Retrieve a Sora video job
curl --request GET \
--url https://api.cometapi.com/v1/videos/{video_id} \
--header 'Authorization: Bearer <token>'{
"id": "video_69b25d5f467c81908733a56bc236b4df",
"size": "1280x720",
"error": null,
"model": "sora-2",
"object": "video",
"prompt": "A paper airplane glides across a desk.",
"status": "in_progress",
"seconds": "4",
"progress": 0,
"created_at": 1773296991,
"expires_at": null,
"completed_at": null,
"remixed_from_video_id": null
}Gunakan endpoint ini setelah Anda memulai sebuah job Sora. Endpoint ini melaporkan status job saat ini, ukuran dan durasi yang dikonfigurasi, serta error apa pun yang dikembalikan oleh provider.
Perhatikan field berikut
statusuntuk status siklus hidupprogressuntuk sinyal progress secara kasarerrorketika provider menolak atau job gagalexpires_atsetelah selesai jika Anda perlu mengetahui kapan aset sementara kedaluwarsa
Poll hingga selesai
Buat atau remix video terlebih dahulu
Mulai dengan Create Video atau Remix Video.
Poll berdasarkan id
Pass
id yang dikembalikan ke sini dan terus periksa hingga job mencapai completed atau failed.Unduh file
Ketika job berstatus
completed, lanjutkan ke Retrieve Video Content.Bentuk response di CometAPI
Langkah ini sangat sesuai dengan alur polling Sora. CometAPI mempertahankan bentuk objek bergaya OpenAI sehingga Anda dapat menghubungkan pemeriksaan status dengan penyesuaian minimal.Otorisasi
Bearer token authentication. Use your CometAPI key.
Parameter Path
Video id returned by the create or remix endpoint.
Respons
200 - application/json
Current job state.
⌘I
Retrieve a Sora video job
curl --request GET \
--url https://api.cometapi.com/v1/videos/{video_id} \
--header 'Authorization: Bearer <token>'{
"id": "video_69b25d5f467c81908733a56bc236b4df",
"size": "1280x720",
"error": null,
"model": "sora-2",
"object": "video",
"prompt": "A paper airplane glides across a desk.",
"status": "in_progress",
"seconds": "4",
"progress": 0,
"created_at": 1773296991,
"expires_at": null,
"completed_at": null,
"remixed_from_video_id": null
}