Dokumentacja referencyjna API
Przewodniki integracji
Cennik i rozliczenia
Oficjalne API
Pobieranie wideo
Użyj CometAPI GET /v1/videos/, aby pobrać status wideo Sora 2, postęp oraz metadane, takie jak czas trwania, wymiary, znaczniki czasu i termin wygaśnięcia.
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
}Użyj tego endpointu po uruchomieniu zadania Sora. Zwraca on bieżący stan zadania, skonfigurowany rozmiar i czas trwania oraz ewentualny błąd zwrócony przez dostawcę.
Obserwuj te pola
statusdla stanu cyklu życiaprogressjako przybliżony sygnał postępuerror, gdy dostawca odrzuci zadanie lub wystąpi błądexpires_atpo zakończeniu, jeśli chcesz wiedzieć, kiedy tymczasowe zasoby wygasną
Odpytuj aż do zakończenia
Najpierw utwórz lub zremiksuj wideo
Zacznij od Create Video lub Remix Video.
Odpytuj po id
Przekaż tutaj zwrócone
id i sprawdzaj dalej, aż zadanie osiągnie stan completed lub failed.Pobierz plik
Gdy zadanie ma status
completed, przejdź do Retrieve Video Content.Kształt odpowiedzi w CometAPI
Ten krok ściśle odpowiada workflow odpytywania Sora. CometAPI zachowuje kształt obiektu w stylu OpenAI, dzięki czemu możesz podłączyć sprawdzanie statusu przy minimalnej liczbie zmian.Autoryzacje
Bearer token authentication. Use your CometAPI key.
Parametry ścieżki
Video id returned by the create or remix endpoint.
Odpowiedź
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
}