Skip to main content
GET
タスクステータスの照会

承認

Authorization
string
header
必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得:

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加:

パスパラメータ

task_id
string
必須

タスクID、照会時は{}を無視し、非同期タスクレスポンスボディのidをパスの末尾に追加してください

レスポンス

タスクステータスの詳細

created
integer

タスク作成タイムスタンプ

例:

1756817821

id
string

タスク ID

例:

"task-unified-1756817821-4x3rx6ny"

model
string

使用されたモデル

例:

"gemini-3-pro-image-preview"

object
enum<string>

タスクタイプ

利用可能なオプション:
image.generation.task,
video.generation.task,
audio.generation.task
例:

"image.generation.task"

progress
integer

タスク進捗率

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

100

status
enum<string>

タスクステータス。注意:上流でまだ待機中でも、照会 API は "processing" を返すため、クライアントは通常 processing / completed / failed のみを目にします。

利用可能なオプション:
pending,
processing,
completed,
failed
例:

"completed"

type
enum<string>

タスクタイプ

利用可能なオプション:
image,
video,
audio,
text
例:

"image"

duration
integer

タスクの所要時間(秒)。status が "completed" または "failed" のときのみ返されます。

例:

30

video_duration
number

実際に生成された動画の長さ(秒)。一部の動画モデル(例:Kling)の終了状態でのみ返されます。

例:

5

draft_expires_at
string<date-time>

正式動画に変換できる期限(UTC、RFC 3339)。作成時に draft: true を指定した Seedance 2.5 プレビュー動画が completed になった場合にのみ返されます。この時刻を過ぎると Seedance 2.5 Draft-to-Video で変換できなくなります

例:

"2026-09-23T17:19:36Z"

source_task_id
string

この正式動画の変換元となったプレビュー動画のタスク ID。Seedance 2.5 Draft-to-Video タスクでのみ返されます

例:

"task-unified-1774857405-abc123"

results
string<uri>[]

結果 URL のリスト。status が "completed" でモデルが URL 結果を生成する場合のみ返され、それ以外ではフィールド自体が存在しません。

例:
result_data
any

モデル固有の完全な結果オブジェクト。画像モデルでは [{"url": ...}] のようなオブジェクト配列(results と同じ URL)。一部のモデルはより詳細なオブジェクトを返します(例:Suno は楽曲オブジェクト)。構造化結果のないモデルでは返されません。

例:
usage
object

使用量と課金情報。status が "completed" のときのみ返されます。credits_used と cost は常に含まれ、トークン系フィールドはトークン課金モデル(例:gpt-image-2)でのみ返されます。一部のモデルではモデル固有の課金フィールドが追加されます。

error
object | null

タスク失敗時のエラー情報(status が failed の場合のみ)。注意:ここでの error.code は文字列型のビジネスエラーコードで、HTTP ステータスコードとは異なります。完全なリストはエラーコードリファレンスを参照してください。

task_info
object

タスクの詳細情報

effective_speed
enum<string>

Midjourney V7 variation / pan / outpaint: prompt は任意です。省略、空文字、空白のみ、または制御対象の速度・バージョン指定を除去すると空になる場合は、speed=turbo でも Fast で実行し Fast 料金を適用します。有効な本文がある場合、速度の省略または fast は Fast、turbo は Turbo で実行し Fast の2倍の料金です。Playground は Fast のみです。ソースは現在のユーザーが所有する完了済みタスクが必要です。prompt なしでは画像生成、および対応する variation・pan・outpaint の結果を使用できます。 Historical tasks retain their recorded execution speed and billing.

利用可能なオプション:
draft,
fast,
turbo