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 키

다음 필드 확인

작업 폴링

인증

경로 매개변수

응답

​다음 필드 확인

​작업 폴링

인증

경로 매개변수

응답

다음 필드 확인

작업 폴링