---
title: "Get a Generation by ID"
method: GET
path: "/v2/generation/{id}"
tags: ["Manage Generations"]
---

# Get a Generation by ID

`GET /v2/generation/{id}`

Get a generations status and data, you can use this endpoint for polling if you don't have a webhook setup.

## Path parameters

- `id` string, required

## Response `200`

Response for status 200

- union
  - object — The generation is complete and you can get the download links from the response
    - `apiKeyId` string, required
    - `creditCost` number, required
    - `createdAt` integer, required — timestamp in milliseconds since epoch
    - `completedAt` integer — timestamp in milliseconds since epoch
    - `webhookUrl` string
    - `input` object, required
      - `prompt` string, required
      - `model` 'topaz-video' | 'heygen' | 'hailuo-2' | 'hailuo-23' | 'hailuo-h3' | 'kling-25' | 'kling-26' | 'kling-3' | 'kling-3-turbo' | 'kling-motion' | 'kling-motion-3' | 'kling-lipsync' | 'o1-elements' | 'o1-frames' | 'o1-transformation' | 'o1-video-reference' | 'o3-elements' | 'o3-frames' | 'o3-transformation' | 'o3-video-reference' | 'midjourney-sd' | 'seedance-pro-fast' | 'bytedance-upscale' | 'seedance-2' | 'seedance-2-mini' | 'lip-sync' | 'avatar-talk' | 'seedance-2.5' | 'grok-imagine-1.5' | 'wan-3.0' | 'veed-lipsync-v2' | 'topaz' | 'normal-upscale' | 'o1' | 'o3' | 'kling-element-gen' | 'kontext' | 'flux1.1-pro-ultra' | 'seedream-4' | 'seedream-45' | 'gemini-2-5' | 'gemini-3' | 'nano-2' | 'gpt-image' | 'gpt-image-1.5' | 'midjourney' | 'crystal' | 'gpt-image-2' | 'seedream5-lite' | 'gpt-image-2-5-flare' | 'gpt-image-2-5-sunburst' | 'elevenlabs-2' | 'elevenlabs-3' | 'suno-5.5' | 'suno-6.0' | 'suno-6.0-wild', required
      - `type` 'video' | 'audio' | 'image' | 'prompt', required
      - `inputImageIds` string[], required
      - `inputVideoIds` string[], required
      - `inputAudioIds` string[], required
    - `status` 'completed', required
    - `outputs` object[], required
      - `private` string, required — Download link that requires an API key
      - `publicTemporary` string, required — Temporary download link (valid for 10-30 minutes), does not require an API key
  - object — The generation failed, the reason is provided in the response.
    - `apiKeyId` string, required
    - `creditCost` number, required
    - `createdAt` integer, required — timestamp in milliseconds since epoch
    - `completedAt` integer — timestamp in milliseconds since epoch
    - `webhookUrl` string
    - `input` object, required
      - `prompt` string, required
      - `model` 'topaz-video' | 'heygen' | 'hailuo-2' | 'hailuo-23' | 'hailuo-h3' | 'kling-25' | 'kling-26' | 'kling-3' | 'kling-3-turbo' | 'kling-motion' | 'kling-motion-3' | 'kling-lipsync' | 'o1-elements' | 'o1-frames' | 'o1-transformation' | 'o1-video-reference' | 'o3-elements' | 'o3-frames' | 'o3-transformation' | 'o3-video-reference' | 'midjourney-sd' | 'seedance-pro-fast' | 'bytedance-upscale' | 'seedance-2' | 'seedance-2-mini' | 'lip-sync' | 'avatar-talk' | 'seedance-2.5' | 'grok-imagine-1.5' | 'wan-3.0' | 'veed-lipsync-v2' | 'topaz' | 'normal-upscale' | 'o1' | 'o3' | 'kling-element-gen' | 'kontext' | 'flux1.1-pro-ultra' | 'seedream-4' | 'seedream-45' | 'gemini-2-5' | 'gemini-3' | 'nano-2' | 'gpt-image' | 'gpt-image-1.5' | 'midjourney' | 'crystal' | 'gpt-image-2' | 'seedream5-lite' | 'gpt-image-2-5-flare' | 'gpt-image-2-5-sunburst' | 'elevenlabs-2' | 'elevenlabs-3' | 'suno-5.5' | 'suno-6.0' | 'suno-6.0-wild', required
      - `type` 'video' | 'audio' | 'image' | 'prompt', required
      - `inputImageIds` string[], required
      - `inputVideoIds` string[], required
      - `inputAudioIds` string[], required
    - `status` 'failed', required
    - `errorMessage` string, required
    - `reason` string, required
  - object — The generation is in progress and is not yet complete
    - `apiKeyId` string, required
    - `creditCost` number, required
    - `createdAt` integer, required — timestamp in milliseconds since epoch
    - `completedAt` integer — timestamp in milliseconds since epoch
    - `webhookUrl` string
    - `input` object, required
      - `prompt` string, required
      - `model` 'topaz-video' | 'heygen' | 'hailuo-2' | 'hailuo-23' | 'hailuo-h3' | 'kling-25' | 'kling-26' | 'kling-3' | 'kling-3-turbo' | 'kling-motion' | 'kling-motion-3' | 'kling-lipsync' | 'o1-elements' | 'o1-frames' | 'o1-transformation' | 'o1-video-reference' | 'o3-elements' | 'o3-frames' | 'o3-transformation' | 'o3-video-reference' | 'midjourney-sd' | 'seedance-pro-fast' | 'bytedance-upscale' | 'seedance-2' | 'seedance-2-mini' | 'lip-sync' | 'avatar-talk' | 'seedance-2.5' | 'grok-imagine-1.5' | 'wan-3.0' | 'veed-lipsync-v2' | 'topaz' | 'normal-upscale' | 'o1' | 'o3' | 'kling-element-gen' | 'kontext' | 'flux1.1-pro-ultra' | 'seedream-4' | 'seedream-45' | 'gemini-2-5' | 'gemini-3' | 'nano-2' | 'gpt-image' | 'gpt-image-1.5' | 'midjourney' | 'crystal' | 'gpt-image-2' | 'seedream5-lite' | 'gpt-image-2-5-flare' | 'gpt-image-2-5-sunburst' | 'elevenlabs-2' | 'elevenlabs-3' | 'suno-5.5' | 'suno-6.0' | 'suno-6.0-wild', required
      - `type` 'video' | 'audio' | 'image' | 'prompt', required
      - `inputImageIds` string[], required
      - `inputVideoIds` string[], required
      - `inputAudioIds` string[], required
    - `status` 'processing', required

## Other responses

- `400` — Response for status 400
- `401` — Response for status 401
- `403` — Response for status 403
- `500` — Response for status 500

## Changes

- **2026-09-16** `a4670b5de4ef` — 3 warning
  - added the new `veed-lipsync-v2` enum value to the `oneOf[subschema #1: Completed]/input/model` response property for the response status `200`
  - added the new `veed-lipsync-v2` enum value to the `oneOf[subschema #2: Failed]/input/model` response property for the response status `200`
  - added the new `veed-lipsync-v2` enum value to the `oneOf[subschema #3: Processing]/input/model` response property for the response status `200`
- **2026-09-13** `f3e462ca4de2` — 6 warning
  - added the new `gpt-image-2-5-flare` enum value to the `oneOf[subschema #1: Completed]/input/model` response property for the response status `200`
  - added the new `gpt-image-2-5-flare` enum value to the `oneOf[subschema #2: Failed]/input/model` response property for the response status `200`
  - added the new `gpt-image-2-5-flare` enum value to the `oneOf[subschema #3: Processing]/input/model` response property for the response status `200`
  - added the new `gpt-image-2-5-sunburst` enum value to the `oneOf[subschema #1: Completed]/input/model` response property for the response status `200`
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/radinai/apis/api/changes/v2/generation/:id/get.md)

---

[API](https://skmtc.dev/radinai/apis/api.md) · [All operations](https://skmtc.dev/radinai/apis/api/llms.txt) · [OpenAPI document](https://skmtc.dev/radinai/apis/api/revisions/4555b7f121b7?raw)