Utwórz film Omni

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Użyj tego endpointu beta, aby utworzyć zadanie tekst-na-wideo lub wideo-na-wideo. API natychmiast zwraca identyfikator zadania, dlatego zapisz zwrócone id i odpytuj zadanie, aż osiągnie status końcowy. Wybierz typ zawartości żądania odpowiadający trybowi wejściowemu. Kontrolki tekst-na-wideo wysyłaj jako pola multipart/form-data. Edycję wideo referencyjnego wysyłaj jako treść application/json.

Wybierz tryb wejściowy

Cel	Typ zawartości	Wymagane pola	Pola opcjonalne
Tekst na wideo	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Wideo na wideo	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

Przykłady tekst-na-wideo używają model=omni-fast. Przykłady wideo-na-wideo używają model=omni-fast-v2v. Użyj Wyświetl dostępne modele aby potwierdzić, że identyfikator modelu jest widoczny dla Twojego klucza API.

Edytuj wideo referencyjne

W przypadku wideo-na-wideo zakoduj lokalny plik MP4 w formacie base64 i poprzedź zakodowane bajty prefiksem data:video/mp4;base64,. Wyślij kompletny adres URL danych w polu video. Opisz żądane zmiany w prompt. Wskaż też tematy, obiekty, kompozycję lub ruch, które wynik powinien zachować. Selektor przykładów kodu zawiera przykłady Shell, Python i JavaScript, które odczytują reference.mp4 z katalogu roboczego. Ten format żądania obejmuje wbudowany adres URL danych MP4. Nie definiuje danych wejściowych URL, innych formatów kontenerów wideo ani limitów rozmiaru pliku.

Ustaw czas trwania, proporcje i rozdzielczość

Omni ma oznaczenie beta, ponieważ stabilność generowania może zależeć od danych wejściowych i wybranej ścieżki. Pierwsze żądanie powinno być niewielkie, a przed poleganiem na określonym renderowanym czasie trwania lub rozmiarze klatki sprawdź ukończone wideo.

Ustawienie	Obsługiwane wartości	Domyślna	Zachowanie wartości granicznych
`seconds`	Zacznij od `4`	Zależne od ścieżki	Traktuj to jako żądany czas trwania i zweryfikuj ukończony plik MP4, ponieważ czas trwania wyniku może się różnić.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` może renderować wynik w pionie. `1:1` może zostać zaakceptowane podczas renderowania w poziomie.
`resolution`	Zacznij od `720p`; `1080p` może zostać zaakceptowane	`720p`	Bieżące dane wyjściowe produkcyjne mogą być normalizowane do `720p`, nawet gdy zażądano `1080p`.

Żądanie	Zaobserwowana klatka wynikowa
`resolution=720p`, `aspect_ratio=16:9`	`1280x720`
`resolution=720p`, `aspect_ratio=9:16`	`720x1280`
`resolution=720p`, `aspect_ratio=1:1`	`1280x720`
`resolution=1080p`, `aspect_ratio=16:9`	`1280x720`

Ponieważ ten endpoint jest w wersji beta, traktuj aspect_ratio i resolution jako preferencje generowania i zweryfikuj pobrany plik MP4, zanim zaczniesz polegać na końcowych pikselach.

Przebieg zadania

Utwórz zadanie

Wyślij żądanie z typem zawartości dla wybranego trybu wejściowego i zapisz zwrócone id.

Odpytuj zadanie

Wywołuj Pobierz film Omni aż status będzie mieć wartość completed lub failed.

Pobierz wynik

Gdy zadanie ma status completed, wywołaj Pobierz zawartość filmu Omni aby pobrać plik MP4.

Autoryzacje

Authorization

string

header

wymagane

Bearer authentication. Use your CometAPI API key.

Treść

model

string

wymagane

Omni model ID for this endpoint. Use omni-fast for text-to-video.

Przykład:

"omni-fast"

prompt

string

wymagane

Text prompt that describes the video to generate.

Przykład:

"Ocean waves rolling onto a sandy beach at golden hour"

seconds

string

Requested clip duration in seconds. The completed video can use a different duration.

Przykład:

"4"

aspect_ratio

enum<string>

domyślnie:16:9

Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.

Dostępne opcje:

16:9,

9:16,

1:1

Przykład:

"16:9"

resolution

string

Output resolution preference. Start with 720p. A request for 1080p can render at 720p.

Przykład:

"720p"

Odpowiedź

200 - application/json

Task accepted. Store the returned id and poll GET /v1/videos/{task_id}.

string

wymagane

Task ID. Use this value with retrieve and content endpoints.

Przykład:

"task_example"

object

string

wymagane

Object type. Video tasks return video.

Przykład:

"video"

model

string

wymagane

Model ID used for the task.

Przykład:

"omni-fast"

status

enum<string>

wymagane

Task lifecycle status. Poll until the value is completed, failed, or error.

Dostępne opcje:

queued,

in_progress,

completed,

failed,

error

Przykład:

"queued"

progress

integer

wymagane

Task progress as a coarse percentage.

Wymagany zakres: 0 <= x <= 100

Przykład:

0

created_at

integer

wymagane

Task creation time as a Unix timestamp in seconds.

Przykład:

1779938152

task_id

string

Compatibility alias for id when present.

Przykład:

"task_example"

completed_at

integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Przykład:

1779938219

video_url

string

Temporary video delivery URL. This field appears on completed tasks.

Przykład:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Show child attributes

Pobieranie treści wideo Vidu

Poprzedni

Pobierz wideo Omni

Następny

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Moderacja treści

Klucze API

Wybierz tryb wejściowy

Edytuj wideo referencyjne

Ustaw czas trwania, proporcje i rozdzielczość

Przebieg zadania

Autoryzacje

Treść

Odpowiedź

​Wybierz tryb wejściowy

​Edytuj wideo referencyjne

​Ustaw czas trwania, proporcje i rozdzielczość

​Przebieg zadania

Autoryzacje

Treść

Odpowiedź

Wybierz tryb wejściowy

Edytuj wideo referencyjne

Ustaw czas trwania, proporcje i rozdzielczość

Przebieg zadania