Retrieve a task

GET/api/gateway/v1/tasks/{id}

Reads and cancellation use the original frozen task identity, not current model configuration. The key must retain modelInvoke and permission for the original project and route. Task recovery remains available during financial recovery subject to current identity and product authorization. Unknown or expired tasks may have been submitted: inspect and reconcile the existing task before creating another invocation. HTTP disconnect does not cancel a task.

组织 API Key 鉴权

Authorization: Bearer $SINECLOUD_API_KEY

所需权限: modelInvoke

参数

id · path · 必填

routeId · query · 可选

Optional original route assertion; mismatches return 404. Takes precedence over x-sine-route-id.

x-sine-route-id · header · 可选

Optional original route assertion when routeId is absent.

x-sine-project-id · header · 可选

Select an organization project. A project-restricted key defaults to its bound project and cannot select another project. The projectId query parameter takes precedence.

projectId · query · 可选

Optional project selection; takes precedence over x-sine-project-id and must respect the key restriction.

响应

200

Current task, including nonterminal, unknown and expired states.

400

Invalid request, project identifier, unsupported model parameters or operation configuration.

401

Missing, expired, revoked or invalid organization Bearer API key.

403

The key scope, project restriction, route policy, current membership or product entitlement denies access.

404

The project, route or authorized task was not found.

429

Rate or concurrency limit reached. Honor Retry-After when returned.

500

Sanitized Cloud or Gateway failure.

503

Gateway or durable task execution is unavailable. Restore the required service before continuing.