Skip to main content
GET
Read a stored task / 查询任务
API preview: generation providers are not connected. An authenticated request can return 503 without creating a task or charging credits.

Follow the whole lifecycle

Read individual items

The same parent can contain low-cost and official successes. Never assume the final item’s channel applies to every result. This simplified example omits output URLs, errors, and timestamps.

Poll without creating extra work

Query the existing task ID at intervals, honor Retry-After, and add backoff when a task takes longer. Read already completed items while other items are running. Do not hold a new generation request open as a polling mechanism. Download before the returned expires_at. File expiry does not change the historical success state or automatically refund credits.

Authorizations

Authorization
string
header
required

API key beginning as_. Keep on the server. Scope permissions are checked separately.

Path Parameters

id
string
required

Stored task ID / 已存任务 ID

Response

Stored task and per-item billing

task_id
string
required
model
string
required
modality
string
required
status
string
required

Operation status. Possible states include queued, running, falling_back, reconciliation_required, succeeded, partially_succeeded, failed, and cancelled.

output_count
integer
required
Required range: 1 <= x <= 4
fallback
boolean
required
created_at
string<date-time>
required
duration_ms
integer
required

Completed duration; currently zero for unfinished tasks.

Required range: x >= 0
counts
object
required
billing
object
required
items
object[]
required