Dokumentacja referencyjna API
Przewodniki integracji
Cennik i rozliczenia
Oficjalne API
Tworzenie wideo
Użyj POST /v1/videos, aby tworzyć zadania generowania wideo Sora 2 na podstawie promptów tekstowych lub obrazów referencyjnych, a następnie sprawdzaj status po ID zadania, aby pobrać wyniki.
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"
}Użyj tego endpointu, aby rozpocząć nowe zadanie renderowania Sora na podstawie tekstu lub tekstu plus jednego obrazu referencyjnego. API natychmiast zwraca id wideo i nie czeka na zakończenie renderowania.
Zacznij od najmniejszego użytecznego zadania
- Użyj
sora-2do szybszych iteracji lubsora-2-pro, gdy jakość wyjściowa jest ważniejsza niż szybkość - W pierwszym żądaniu ustaw
secondsna4 - Zacznij od
size: 1280x720, chyba że potrzebujesz formatu pionowego - Prześlij maksymalnie jeden obraz referencyjny
Pełny przepływ end-to-end
Sprawdzaj status, aż zadanie się zakończy
Wywołuj Retrieve Video, aż status zmieni się na
completed lub failed.Pobierz wynik lub utwórz remix
Gdy renderowanie się zakończy, pobierz plik przez Retrieve Video Content. Jeśli chcesz uzyskać ukierunkowany wariant, użyj Remix Video na ukończonym wyniku.
Zachowanie Sora, które nadal obowiązuje
OpenAI dokumentuje ten sam przepływ tworzenie -> pobieranie statusu -> pobieranie pliku w Videos API. W CometAPI zachowujesz strukturę żądania Sora, ale używasz base URL i klucza CometAPI. Gotowe adresy URL pobierania są tymczasowe, więc skopiuj ukończone zasoby do własnej pamięci masowej, jeśli potrzebujesz długiego okresu przechowywania.Autoryzacje
Bearer token authentication. Use your CometAPI key.
Treść
multipart/form-data
Text prompt that describes the video you want to create.
Przykład:
"A paper airplane glides across a desk."
Sora model ID. Choose a current model from the Models page.
Przykład:
"sora-2"
Clip duration in seconds.
Dostępne opcje:
4, 8, 12 Przykład:
"4"
Output resolution formatted as width x height.
Dostępne opcje:
720x1280, 1280x720, 1024x1792, 1792x1024 Przykład:
"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"
}