Flux 3動画を取得する

GET

videos

{task_id}

cURL

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

import os

import requests

task_id = "<task_id>"
response = requests.get(
    f"https://api.cometapi.com/v1/videos/{task_id}",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"]
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())

const taskId = "<task_id>";
const response = await fetch(
  `https://api.cometapi.com/v1/videos/${taskId}`,
  { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
);

if (!response.ok) {
  throw new Error(await response.text());
}

console.log(await response.json());

<?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_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "flux-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Flux 3動画タスクを作成した後に、このエンドポイントを使用します。タスクが完了すると、レスポンスにはvideo_urlが含まれます。

以下のフィールドを確認

status はqueued、in_progress、completed、またはfailedです。
progress は0から100までの大まかな完了率です。
video_url はタスクが完了すると表示されます。
error はタスクが失敗すると表示されます。

タスクをポーリングする

まずタスクを作成する

まず、 Flux 3動画を作成するを実行し、返されたidを保存します。

タスクの状態を取得する

statusがcompletedまたはfailedになるまで、タスクIDをこのエンドポイントに送信します。

MP4ファイルをダウンロードする

statusがcompletedになったら、次を呼び出します。 Flux 3動画コンテンツをダウンロードする.

承認

Authorization

string

header

必須

Bearer authentication. Use your CometAPI API key.

パスパラメータ

task_id

string

必須

Task ID returned by POST /v1/videos.

レスポンス

Current Flux 3 video task state.

string

必須

Task ID. Use this value as task_id in retrieve and content requests.

例:

"<task_id>"

object

string

必須

Object type for the asynchronous video task.

Allowed value: "video"

model

string

必須

Model ID that the task uses.

Allowed value: "flux-3"

status

enum<string>

必須

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

利用可能なオプション:

queued,

in_progress,

completed,

failed

progress

integer

必須

Task progress as a coarse percentage.

必須範囲: 0 <= x <= 100

created_at

integer<int64>

必須

Task creation time as a Unix timestamp in seconds.

task_id

string

Compatibility alias for id. This field can be omitted from retrieve responses.

例:

"<task_id>"

completed_at

integer<int64>

Task completion time as a Unix timestamp in seconds when the task provides one.

expires_at

integer<int64>

Result expiration time as a Unix timestamp in seconds when the task provides one.

video_url

string<uri>

Video delivery URL. This field appears on completed tasks.

例:

"https://media.example.com/flux-3-result.mp4"

error

object

Failure details. This field appears when the task fails.

Show child attributes

最終更新日 2026年8月14日

cURL

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

import os

import requests

task_id = "<task_id>"
response = requests.get(
    f"https://api.cometapi.com/v1/videos/{task_id}",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"]
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())

const taskId = "<task_id>";
const response = await fetch(
  `https://api.cometapi.com/v1/videos/${taskId}`,
  { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
);

if (!response.ok) {
  throw new Error(await response.text());
}

console.log(await response.json());

<?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_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "flux-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

コンテンツモデレーション

APIキー

以下のフィールドを確認

タスクをポーリングする

承認

パスパラメータ

レスポンス

​以下のフィールドを確認

​タスクをポーリングする

承認

パスパラメータ

レスポンス

以下のフィールドを確認

タスクをポーリングする