---
title: "List Generations"
method: GET
path: "/v2/generation/list"
tags: ["Manage Generations"]
---

# List Generations

`GET /v2/generation/list`

List Generation requests

## Query parameters

- `genTypes` string[] — An array of output types you want to list, if not selected, all types will be returned.
- `offset` union, required
  - string, numeric
  - number
- `limit` union, required
  - string, numeric
  - number

## Response `200`

Response for status 200

- object
  - `total` number, required — Total number of generations matching your query
  - `items` union[], required — Generations matching limit, offset and other queries you have specified
    - 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 `items/items/oneOf[subschema #1: Completed]/input/model` response property for the response status `200`
  - added the new `veed-lipsync-v2` enum value to the `items/items/oneOf[subschema #2: Failed]/input/model` response property for the response status `200`
  - added the new `veed-lipsync-v2` enum value to the `items/items/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 `items/items/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 `items/items/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 `items/items/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 `items/items/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/list/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)