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

# Get a generation by ID

`GET /v2/generations/{id}`

## Path parameters

- `id` string, required

## Response `200`

Generation details

- GenerationDto
  - `id` string, required
  - `organizationId` string, required
  - `userId` string, nullable, required
  - `apiKeyId` string, nullable, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `startedAt` string, date-time, nullable, required
  - `finishedAt` string, date-time, nullable, required
  - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'REJECTED', required
  - `model` object, required
    - `id` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `type` string, required
    - `version` string, required
    - `features` string[]
    - `deprecatedAt` string, date-time, nullable, required
  - `modelName` string, required
  - `inputs` object[], required
    - `url` string, uri
    - `assetId` string
    - `type` 'video' | 'image' | 'audio' | 'text', required
    - `refId` string
    - `generatedBy` 'tts'
    - `segments_secs` array[]
      - number[]
    - `segments_frames` array[]
      - number[]
    - `trim_secs` number[]
    - `provider` object
      - `name` string, required
      - `script` string, required
      - `voiceId` string, required
      - `stability` number
      - `similarityBoost` number
  - `webhookUrl` string, nullable, required
  - `thumbnailUrl` string, nullable, required
  - `frameCount` number, nullable, required
  - `options` object, required
    - `prompt` union
      - 'happy' | 'sad' | 'angry' | 'disgusted' | 'surprised' | 'neutral'
      - string
    - `prompt_image_uris` string[]
    - `i2v_prompt` string
    - `system_prompt` string
    - `temperature` number, nullable
    - `sync_mode` 'cut_off' | 'bounce' | 'loop' | 'silence' | 'remap'
    - `model_mode` union
      - string
      - string
    - `active_speaker_detection` union
      - object
        - `auto_detect` boolean
        - `use_v2` boolean
        - `v3` boolean
        - `frame_number` number
        - `coordinates` number[]
        - `bounding_boxes` array[]
          - number[], nullable
        - `bounding_boxes_url` string
        - `face_image` string
      - boolean
    - `face_boxes_url` string
    - `occlusion_detection_enabled` boolean
    - `reasoning_enabled` boolean
    - `refinement_enabled` boolean
    - `blending_mode` 'default' | 'advanced' | 'disabled'
    - `output_file_name` string
    - `output_bucket_name` string
    - `output_bucket_path` string
    - `disable_blending` boolean
    - `pad_percent` number
    - `mask_uri` string
    - `mask_inner_box` integer[], nullable
    - `audio_guidance_scale` number, nullable
    - `num_steps` integer, nullable
    - `use_retinaface` boolean
    - `use_insightface` boolean
    - `disable_scene_detection` boolean
    - `extra_services_options` object
    - `original_audio_url` string
    - `occlusion_prompt` string
    - `rotate` number
    - `active_speaker` boolean
    - `speedup` number, nullable
    - `output_format` 'mp4' | 'mov'
    - `fps` number, nullable
    - `output_resolution` number[], nullable
    - `pads` number[]
    - `gb` number, nullable
    - `mb` number, nullable
    - `quality` string, nullable
    - `img_size` number[], nullable
    - `pickle_mode` string, nullable
    - `cf_batch_size` number, nullable
    - `resize_factor` number, nullable
    - `expressiveness` number, nullable
    - `inp_batch_size` number, nullable
    - `fidelity_weight` number, nullable
    - `wav2lip_batch_size` number, nullable
    - `face_det_batch_size` number, nullable
  - `segments` object[], nullable
    - `startTime` number
    - `endTime` number
    - `startFrame` number
    - `endFrame` number
    - `audioInput` object
      - `refId` string, required
      - `startTime` number
      - `endTime` number
    - `optionsOverride` object
      - `active_speaker_detection` object
        - `auto_detect` boolean
        - `use_v2` boolean
        - `v3` boolean
        - `frame_number` number
        - `coordinates` number[]
        - `bounding_boxes` array[]
          - number[], nullable
        - `bounding_boxes_url` string
        - `face_image` string
      - `sync_mode` 'cut_off' | 'bounce' | 'loop' | 'silence' | 'remap'
      - `occlusion_detection_enabled` boolean
      - `temperature` number
      - `disable_blending` boolean
      - `pad_percent` number
      - `mask_uri` string
      - `use_retinaface` boolean
      - `use_insightface` boolean
  - `outputMediaUrl` string, nullable, required
  - `segmentOutputMediaUrl` string, nullable, required
  - `segmentOutputBucketPath` string, nullable, required
  - `creatorName` string, nullable
  - `outputMediaLength` number, nullable, required
  - `potentialError` object, nullable, required
    - `status` number
    - `message` string, required
    - `errorCode` string
    - `docsLink` string, uri
  - `isPublic` boolean, nullable, required
  - `deletedAt` string, date-time, nullable, required
  - `projectId` string, nullable, required
  - `outputFileName` string, nullable
  - `outputExtension` string, nullable

## Other responses

- `404` — Generation not found

---

[API](https://skmtc.dev/sync/apis/sync-api-v2.md) · [All operations](https://skmtc.dev/sync/apis/sync-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sync/sync-api-v2/revisions/595901a0ee97/schema)