生成タスクの一覧を取得
ページ分割、モデル・状態・ID の絞り込みで生成タスクと利用可能な出力を取得します。Enterprise タスクにも対応します。
Lists the platform's recorded generation tasks, including Enterprise model tasks, with pagination and optional model, status, and task-ID filters. Filters are combined with AND. With no task-ID filter, lists tasks visible to the authenticated caller.
Use page_num (default 1) and page_size (default 20), each between 1 and 500. total counts visible tasks matching the filters before pagination. Results are ordered by creation time, newest first, with a stable tie-breaker. Concurrent task creation, deletion, or status changes can affect later pages; pagination does not create a cross-request snapshot.
Optional filter.task_ids is repeated once per ID. Supply at most 100 IDs before case-insensitive deduplication. not_found contains only supplied IDs that are missing, deleted, outside the account, or inaccessible; IDs excluded by model/status filters or pagination are not missing. Without an ID filter, not_found is empty. Partial or entirely missing results still return HTTP 200.
For existing integrations, repeated task_ids[] remains supported. When it is the only query parameter, all matching IDs (up to 100) are returned in first-requested order, with page_num: 1 and page_size: 100. Adding a pagination or filter parameter uses normal list pagination and ordering. Do not combine task_ids[] with filter.task_ids. Comma-separated IDs, scope, service-tier filters, and unknown parameters are rejected. The raw query string must not exceed 48 KiB.
outputs contains available results of completed tasks. It is empty when results are not ready, content or files have expired, or no results are retained. Private output positions whose links cannot currently be resolved contain an empty string; output indices remain stable. Save available results before expiry. Naturally expired tasks remain queryable when their safe status metadata is retained, without restoring their content.
This is a read of recorded task state: it does not refresh provider status, advance generation, or settle billing. State may lag behind the provider. A recorded completed task can still have unavailable outputs; use GET /api/v1/model/prediction/{id} for the individual prediction result and its delivery readiness.
Use an ordinary model API key (apikey-...) in the Authorization header. Management keys (mgmt-...) are not accepted. The credential fixes the account; visibility follows the caller's current generation history permissions.
Authorization
ModelKeyBearer Model API key required. Send Authorization: Bearer apikey-....
In: header
Query Parameters
Page number. Pagination applies after visibility and all filters.
1 <= value <= 5001Number of tasks per page. Legacy requests containing only task_ids[] return all requested visible tasks, up to 100.
1 <= value <= 50020Exact Atlas Cloud model ID, such as bytedance/seedance-2.0/text-to-video. Not a provider endpoint ID. Must be nonempty, at most 256 UTF-8 bytes, without surrounding whitespace or control characters.
1 <= length <= 256Exact recorded status, using Atlas Cloud status names. Filtering follows the same status calculation as the returned items.
Value in
- "created"
- "queued"
- "processing"
- "completed"
- "failed"
- "timeout"
- "unknown"
Optional task IDs, repeated as filter.task_ids=task-1&filter.task_ids=task-2.
Supply 1–100 entries before deduplication. Each ID must contain 1–128 ASCII letters, digits, dots, underscores, colons, or hyphens. Empty values and whitespace are rejected. Cannot be combined with task_ids[].
1 <= items <= 100Existing batch-query parameter. When supplied alone, preserves first-requested order and returns all requested visible tasks without the default 20-item page. Cannot be combined with filter.task_ids.
1 <= items <= 100Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/public/v1/tasks?filter.task_ids=task-1&filter.task_ids=task-2&filter.task_ids=task-3"{ "object": "list", "total": 2, "page_num": 1, "page_size": 20, "items": [ { "id": "task-1", "model": "bytedance/seedance-2.0/text-to-video", "status": "completed", "created_at": 1794898800000, "updated_at": 1794898860000, "error": null, "outputs": [ "https://example.com/generated-video.mp4" ] }, { "id": "task-2", "model": "bytedance/seedance-2.0/text-to-video", "status": "timeout", "created_at": 1794898700000, "updated_at": 1794899100000, "error": { "code": 0, "message": "Task timed out" }, "outputs": [] } ], "not_found": [ "task-3" ], "request_id": "req_example"}Last updated on