---
title: "Read and reconcile a Seedance video task"
method: GET
path: "/v1/videos/{requestId}"
tags: ["Generation"]
---

# Read and reconcile a Seedance video task

`GET /v1/videos/{requestId}`

## Request

- Base URL: `https://infer.flow7.org`
- URL: `https://infer.flow7.org/v1/videos/{requestId}`
- Auth: HTTP bearer

Reads current state for an Infer-owned video task. Terminal completion settles the locked reservation exactly once; terminal failure releases it exactly once. Temporary provider errors leave the reservation intact.

## Path parameters

- `requestId` string, required

## Response `200`

Current video task

- VideoObject
  - `id` string, required: Infer-owned task id.
  - `task_id` string, required: Same Infer-owned task id; upstream task ids remain private.
  - `object` 'video', required
  - `model` string, required
  - `status` 'queued' | 'pending' | 'processing' | 'in_progress' | 'completed' | 'failed', required
  - `progress` unknown
  - `metadata` object
    - `url` string, uri: Authenticated Infer content endpoint after completion.
  - `relay` GenerationRelayMetadata
    - `request_id` string
    - `receipt_id` string
    - `price_version` string: Opaque reference (pv_…) to the immutable price version that priced this generation.
    - `tier` 'stable'
    - `customer_cost_usd` number
    - `reserved_cost_usd` number
    - `provider_disclosed` false

## Other responses

- `400`: The request could not be processed.
- `401`: A valid Bearer API key is required.
- `402`: The wallet cannot cover the request's reservation.
- `403`: The key, organization, environment, or scope cannot perform this operation.
- `404`: No active price exists for the requested selector in this environment.
- `409`: The idempotency key is in progress, expired, or otherwise cannot be replayed.
- `413`: The input or request body exceeds a configured limit.
- `422`: A selector, input, output limit, session identifier, or routing option is invalid.
- `429`: The request rate limit or an API-key spend ceiling was reached.
- `500`: Infer could not complete the operation.
- `503`: Live inference is disabled, no eligible route has capacity, or no route completed within the retry budget.

---

[API](https://skmtc.dev/flow7/apis/infer-by-flow7-public-api.md) · [All operations](https://skmtc.dev/flow7/apis/infer-by-flow7-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flow7/apis/infer-by-flow7-public-api/revisions/e73ecffd3cf3?raw)