Przejdź do głównej treści
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"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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-2 do szybszych iteracji lub sora-2-pro, gdy jakość wyjściowa jest ważniejsza niż szybkość
  • W pierwszym żądaniu ustaw seconds na 4
  • Zacznij od size: 1280x720, chyba że potrzebujesz formatu pionowego
  • Prześlij maksymalnie jeden obraz referencyjny

​
Pełny przepływ end-to-end

1

Utwórz zadanie renderowania

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

Sprawdzaj status, aż zadanie się zakończy

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

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

​
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 a current model from the Models page.

Przykład:

"sora-2"

​
seconds
enum<string>
domyślnie:4

Clip duration in seconds.

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

"4"

​
size
enum<string>
domyślnie:1280x720

Output resolution formatted as width x height.

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