Generations

Get a generation

Changed on

Poll for generation status and output. On completion, the response includes presigned URLs to download the generated images.

get/generations/{generation_id}

Request

  • Base URL: https://agents.lumalabs.ai/v1
  • URL: https://agents.lumalabs.ai/v1/generations/{generation_id}
  • Auth: HTTP bearer

Path parameters

generation_idstring uuid required

Generation UUID returned by POST /generations

Response

Generation status

idstring uuid required

Generation identifier

type'image' | 'image_edit' | 'video' | 'video_edit' | 'video_reframe' | 'layering' required

The kind of generation to perform

state'queued' | 'processing' | 'completed' | 'failed' required

Current state of the generation

model'uni-1' | 'uni-1-max' | 'ray-3.2' required

Model identifier. uni-1 is the default image tier; uni-1-max produces higher-quality output than uni-1 at a higher per-image price. ray-3.2 is the public video model for text-to-video, image-to-video, and video-to-video editing.

created_atstring required

Creation timestamp

failure_reasonstring nullable

Human-readable failure description

failure_code'content_moderated' | 'generation_failed' | 'budget_exhausted' | 'output_not_found' | 'image_too_large' | 'unsupported_format' | 'corrupt_input' | 'invalid_request' | 'rate_limited'

Machine-readable failure code for programmatic handling

Changes

  • 2135bbde249cRevision changes
    • warning

      added the new layering enum value to the response property for the response status

    • info

      added the optional property // to the response with the status

  • 1a4de7fe8becRevision changes
    • warning

      added the new ray-3.2 enum value to the response property for the response status

    • warning

      added the new video enum value to the response property for the response status

    • warning

      added the new video_edit enum value to the response property for the response status

    • warning

      added the new video_reframe enum value to the response property for the response status