Co zbudujesz
Prześlesz zadanie wideo Sora 2, zapiszesz zwrócone ID wideo, będziesz sprawdzać status aż do ukończenia zadania i pobierzesz gotową treść wideo.Wymagania wstępne
- Klucz API CometAPI zapisany w
COMETAPI_KEY - Python 3.10+ z
requestslub Node.js 18+ - Worker po stronie serwera lub kolejka zadań do odpytywania
Klucz API, bazowy URL, uwierzytelnianie
Twórz zadania Sora za pomocą:Przykłady kodu
Użyj poniższych zakładek, aby skopiować przykłady w cURL, Python i Node.js.Wyjaśnienie przepływu
Generowanie Sora jest asynchroniczne. Endpoint tworzenia zwraca ID wideo i początkowy status. OdpytujGET /v1/videos/<video_id>, aż status będzie równy completed albo failed. Gdy zadanie zostanie ukończone, pobierz plik za pomocą GET /v1/videos/<video_id>/content.
Używaj dokładnych rozmiarów WxH. Dokumentacja referencyjna Sora API opisuje standardowe rozmiary poziome i pionowe oraz większe rozmiary Pro dla przepływów pracy modelu Pro.
Wspólne parametry
Rozwiązywanie problemów / FAQ
Żądanie utworzenia kończy się niepowodzeniem
Żądanie utworzenia kończy się niepowodzeniem
Użyj danych formularza multipart. Żądania tworzenia Sora w dokumentacji referencyjnej używają pól formularza, a nie treści JSON.
Pobieranie treści kończy się niepowodzeniem
Pobieranie treści kończy się niepowodzeniem
Pobieraj treść dopiero po tym, jak endpoint statusu zwróci
completed. Zapisz gotowy plik we własnym storage.Rozmiar Pro nie działa
Rozmiar Pro nie działa
Używaj większych rozmiarów Pro tylko z workflowem modelu Pro. W przypadku pierwszego żądania zacznij od
1280x720.Następne kroki
- Przeczytaj dokumentację referencyjną API Create a Sora 2 video.
- Odpytuj za pomocą Retrieve a Sora 2 video.
- Pobieraj za pomocą Retrieve Sora 2 video content.
- Znajdź dostępne modele wideo w Models.
- Zapoznaj się z Use polling and webhooks for video generation.
- Oszacuj koszt zadania za pomocą Estimate request cost before calling a model.