Skip to main content
POST
Użyj tego endpointu, aby uruchomić zadanie renderowania Sora na podstawie tekstu lub tekstu z jednym obrazem referencyjnym. API natychmiast zwraca video id i nie czeka na zakończenie renderowania.

Zacznij od najmniejszego użytecznego zadania

  • Użyj sora-2 do szybszej iteracji lub sora-2-pro, gdy jakość wyjściowa jest ważniejsza niż szybkość
  • Ustaw seconds na 4 w pierwszym żądaniu
  • Zacznij od size: 1280x720, chyba że konkretnie potrzebujesz formatu pionowego
  • Prześlij maksymalnie jeden obraz referencyjny

Czas trwania i rozmiar

Sora wymaga pola size w dokładnym formacie WxH. Tokeny rozdzielczości takie jak 720p i etykiety proporcji takie jak 16:9 nie są prawidłowymi wartościami Sora size w tym endpointcie.

Pełny przepływ

1

Utwórz zadanie renderowania

Wyślij model, prompt, seconds i size, a następnie zapisz zwrócone id.
2

Odpytuj, aż zadanie się zakończy

Wywołuj Retrieve Video, aż status zmieni się na completed lub failed.
3

Pobierz wynik

Gdy renderowanie będzie gotowe, pobierz plik za pomocą Retrieve Video Content.

Zachowanie Sora, które nadal obowiązuje

OpenAI dokumentuje ten sam przepływ tworzenie -> pobieranie -> pobieranie pliku w Videos API. W CometAPI zachowujesz format żądania Sora, ale używasz bazowego URL i klucza CometAPI. Gotowe URL-e pobierania są tymczasowe, więc skopiuj ukończone zasoby do własnej pamięci masowej, jeśli potrzebujesz dłuższego przechowywania.

Autoryzacje

Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Treść

multipart/form-data
prompt
string
wymagane

Text prompt that describes the video you want to create.

Przykład:

"A paper airplane glides across a desk."

model
string
domyślnie:sora-2

Sora model ID. Choose an available model from the Models page.

Przykład:

"sora-2"

seconds
enum<string>
domyślnie:4

Clip duration in seconds. Use 4, 8, 12, 16, or 20.

Dostępne opcje:
4,
8,
12,
16,
20
Przykład:

"4"

size
enum<string>
domyślnie:1280x720

Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.

Dostępne opcje:
720x1280,
1280x720,
1024x1792,
1792x1024
Przykład:

"1280x720"

input_reference
file

Optional reference image uploaded as a file. The image should match the target size you request.

Odpowiedź

200 - application/json

Video job accepted.

created_at
integer
wymagane
id
string
wymagane
model
string
wymagane
object
string
wymagane
progress
integer
wymagane
seconds
string
wymagane
size
string
wymagane
status
string
wymagane