Pobierz wideo Omni

GET

videos

{task_id}

cURL

curl https://api.cometapi.com/v1/videos/<TASK_ID> \
  -H "Authorization: Bearer $COMETAPI_KEY"

import os
import time
import requests

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
terminal_statuses = {"completed", "failed"}

while True:
    response = requests.get(
        f"https://api.cometapi.com/v1/videos/{TASK_ID}",
        headers=headers,
        timeout=60,
    )
    response.raise_for_status()
    task = response.json()
    print(task["status"], task.get("progress"))
    if task["status"] in terminal_statuses:
        print(task.get("video_url"))
        break
    time.sleep(10)

const TASK_ID = "<TASK_ID>";
const terminalStatuses = new Set(["completed", "failed"]);

while (true) {
  const response = await fetch(
    `https://api.cometapi.com/v1/videos/${TASK_ID}`,
    { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
  );
  const task = await response.json();
  console.log(task.status, task.progress);
  if (terminalStatuses.has(task.status)) {
    console.log(task.video_url);
    break;
  }
  await new Promise((resolve) => setTimeout(resolve, 10_000));
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/v1/videos/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/v1/videos/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/v1/videos/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

Użyj tego endpointu po utworzeniu zadania beta wideo Omni. Zwraca on stan zadania i zawiera video_url po ukończeniu zadania. Beta

Sprawdź te pola

status informuje, czy zadanie ma stan queued, in_progress, completed czy failed.
progress to przybliżony procent ukończenia.
video_url pojawia się w odpowiedziach dla ukończonych zadań.
error pojawia się, gdy zadanie zakończy się niepowodzeniem.

Przepływ odpytywania

Najpierw utwórz zadanie

Zacznij od Utwórz wideo Omni i zapisz zwrócone id.

Odpytuj według ID zadania

Wysyłaj ID zadania do tego endpointu, aż status osiągnie completed lub failed.

Pobierz plik MP4

Gdy status ma wartość completed, wywołaj Pobierz zawartość wideo Omni.

Autoryzacje

Authorization

string

header

wymagane

Bearer authentication. Use your CometAPI API key.

Parametry ścieżki

task_id

string

wymagane

Task ID returned by POST /v1/videos.

Odpowiedź

Omni video task state.

string

wymagane

Task ID returned by POST /v1/videos.

Przykład:

"task_example"

object

string

wymagane

Object type. Omni 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 or failed.

Dostępne opcje:

queued,

in_progress,

completed,

failed

Przykład:

"completed"

progress

integer

wymagane

Task progress as a coarse percentage.

Wymagany zakres: 0 <= x <= 100

Przykład:

100

created_at

integer

wymagane

Task creation time as a Unix timestamp in seconds.

Przykład:

1779938152

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

Utwórz film Omni

Poprzedni

Pobieranie treści wideo Omni

Następny

cURL

curl https://api.cometapi.com/v1/videos/<TASK_ID> \
  -H "Authorization: Bearer $COMETAPI_KEY"

import os
import time
import requests

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
terminal_statuses = {"completed", "failed"}

while True:
    response = requests.get(
        f"https://api.cometapi.com/v1/videos/{TASK_ID}",
        headers=headers,
        timeout=60,
    )
    response.raise_for_status()
    task = response.json()
    print(task["status"], task.get("progress"))
    if task["status"] in terminal_statuses:
        print(task.get("video_url"))
        break
    time.sleep(10)

const TASK_ID = "<TASK_ID>";
const terminalStatuses = new Set(["completed", "failed"]);

while (true) {
  const response = await fetch(
    `https://api.cometapi.com/v1/videos/${TASK_ID}`,
    { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
  );
  const task = await response.json();
  console.log(task.status, task.progress);
  if (terminalStatuses.has(task.status)) {
    console.log(task.video_url);
    break;
  }
  await new Promise((resolve) => setTimeout(resolve, 10_000));
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/v1/videos/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/v1/videos/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/v1/videos/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

Moderacja treści

Klucze API

Sprawdź te pola

Przepływ odpytywania

Autoryzacje

Parametry ścieżki

Odpowiedź

​Sprawdź te pola

​Przepływ odpytywania

Autoryzacje

Parametry ścieżki

Odpowiedź

Sprawdź te pola

Przepływ odpytywania