---
title: "Get image"
method: GET
path: "/images/{id}"
---

# Get image

`GET /images/{id}`

## Request

- Base URL: `https://api.shortgenius.com/v1`
- URL: `https://api.shortgenius.com/v1/images/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required: The unique ID of the image record to retrieve.

## Response `200`

Successful response

- union: Details of the requested image record.
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `type` 'GeneratedImage' | 'GeneratedImagePreset', required
    - `state` 'pending' | 'generating' | 'completed' | 'error' | 'request_smart_motion' | 'placeholder', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
    - `prompt` string, required
    - `is_nsfw` boolean, required
    - `aspect_ratio` '9:16' | '16:9' | '1:1', required
    - `image_style_id` string, uuid, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `type` 'GeneratedVideo' | 'GeneratedVideoPreset' | 'GeneratedVideoFromCloning', required
    - `state` 'pending' | 'generating' | 'completed' | 'error' | 'request_smart_motion', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
    - `first_frame_image_id` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `type` 'LumaGeneratedVideo', required
    - `state` 'pending' | 'generating' | 'completed' | 'error', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `type` 'Segmentation', required
    - `state` 'pending' | 'generating' | 'completed' | 'error', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `user_id` string, uuid, required
    - `associated_product_id` string, nullable
    - `type` 'Image', required
    - `state` 'completed', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `user_id` string, uuid, required
    - `associated_product_id` string, nullable
    - `type` 'Video', required
    - `state` 'completed', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `type` 'UgcCreator', required
    - `state` 'completed', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `type` 'UgcVideo', required
    - `state` 'pending' | 'generating' | 'completed' | 'error', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `type` 'VideoClip', required
    - `state` 'completed', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `type` 'Segmentation', required
    - `state` 'pending' | 'generating' | 'completed' | 'error', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `state` 'uploading' | 'error' | 'completed' | 'request_smart_motion', required
    - `type` 'UserImage' | 'UserImagePreset', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `state` 'uploading' | 'error' | 'completed' | 'request_smart_motion', required
    - `type` 'UserImageFromPicker', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `state` 'uploading' | 'error' | 'completed' | 'request_smart_motion', required
    - `type` 'UserVideo', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable
  - object
    - `id` string, uuid, required
    - `url` string, nullable, required
    - `associated_product_id` string, nullable
    - `type` 'UserImageSegmentation', required
    - `state` 'pending' | 'generating' | 'error' | 'completed', required
    - `created_at` string, required: Date and time (ISO 8601) when the media was created.
    - `updated_at` string, nullable

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/shortgenius/apis/shortgenius-api.md) · [All operations](https://skmtc.dev/shortgenius/apis/shortgenius-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shortgenius/apis/shortgenius-api/revisions/532abda8ff32?raw)