> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.videogen.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.videogen.io/_mcp/server.

# Get Model 1 generation

GET https://api.videogen.io/v1/models/model-1/generations/{generationId}

Poll until succeeded or failed. Success includes a direct MP4 download URL; this read refreshes expiring signed URLs. Reading never starts another attempt. Available even when new generation is paused or quota is exhausted.

Reference: https://docs.videogen.io/rest-api-reference/models/get-model-1-generation

## Authentication

- `Authorization` header (bearer token, required) — API key from [app.videogen.io/api](https://app.videogen.io/api). The full key is only shown once when you create it.

## Request

### Path parameters

- `generationId` (string, required)

## Response

### 200

Generation status and any completed result.

- `generationId` (string, required)
- `model` (enum, required)
  - Allowed values: `model-1`
- `status` (enum, required)
  - Allowed values: `queued`, `running`, `succeeded`, `failed`
- `seconds` (integer, required)
- `createdAt` (integer, required) — Unix seconds.
- `updatedAt` (integer, required) — Unix seconds.
- `progressPercentage` (double, required, nullable)
- `result` (Model1GenerationResult, required, nullable) — Set for succeeded generations. Null while queued, running or failed, and on a succeeded generation whose output file was archived.
- `error` (ApiError, required, nullable) — Set only for failed generations. Codes include content_policy_violation and generation_failed. Failed attempts retain reserved duration for operator recovery.
- `qualityWarnings` (list of enum, required) — Quality issues found after generation. The video is still delivered. DURATION_MISMATCH means the video's length differs from the requested seconds.
  - Allowed values: `VISUAL_DEFECTS`, `DIALOGUE_ISSUES`, `MUSIC_QUALITY`, `VOICE_CONSISTENCY`, `CONTINUITY_SUPPORT_REDUCED`, `CHECKS_UNAVAILABLE`, `DURATION_MISMATCH`

## Types

### Model1GenerationResult

- `fileId` (string, required)
- `downloadUrl` (string, required) — Direct signed MP4 URL, including generated audio. Read the generation again to refresh it.
- `downloadUrlExpiresAt` (integer, required) — Unix seconds when the signed download URL expires.

### ApiError

Standard error body returned with every non-2xx response (the `default` response of every operation). The HTTP status code conveys the error class; this body carries the details: - `400` invalid request, `401` missing or invalid API key, `403` not permitted (e.g. plan or add-on required, see `requirement`), `404` not found, `409` conflict, `429` rate limited or out of credits, `5xx` server error. Common `code` values include `invalid_request`, `invalid_api_key`, `not_authorized`, `not_found`, `insufficient_credits`, and `rate_limited`. Always branch on `code` (and `requirement.type` when present) rather than parsing `message`.

- `message` (string, required) — Human-readable error description. For display and logging only; do not branch on its exact text.
- `code` (string, optional, nullable) — Machine-readable error code in snake_case (e.g. `invalid_api_key`, `insufficient_credits`). `null` when no specific code applies.
- `requirement` (ErrorRequirement, optional, nullable) — What is needed to resolve the error. Present when the error can be fixed by fulfilling a specific requirement (e.g. purchasing an add-on); `null` otherwise.
- `internalErrorCode` (string, optional, nullable) — Opaque internal error code for debugging. Include this when contacting support. `null` when not applicable.

### ErrorRequirement

What is needed to resolve an error, when it can be fixed by fulfilling a specific requirement (e.g. purchasing an add-on or upgrading the plan).

- `type` (string, required) — Machine-readable requirement type in snake_case (e.g. `purchase_add_on`, `upgrade_plan`).
- `details` (map from string to string, optional) — Key-value pairs with requirement-specific context (e.g. the add-on id to purchase).

## Examples

**Response**

```json
{
  "generationId": "string",
  "model": "model-1",
  "status": "queued",
  "seconds": 1,
  "createdAt": 1,
  "updatedAt": 1,
  "progressPercentage": 1.1,
  "result": {
    "fileId": "string",
    "downloadUrl": "string",
    "downloadUrlExpiresAt": 1
  },
  "error": {
    "message": "string",
    "code": "string",
    "requirement": {
      "type": "string",
      "details": {}
    },
    "internalErrorCode": "string"
  },
  "qualityWarnings": [
    "VISUAL_DEFECTS"
  ]
}
```

**SDK Code**

```python
import requests

url = "https://api.videogen.io/v1/models/model-1/generations/generationId"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```