Generations

type AdvancedControls struct{…}

Per-signal manual conditioning controls for video edits

Depth DepthControloptional

Depth / scene-geometry conditioning control

Blur float64optional

Depth-map blur amount from 0 to 1. Higher values allow more geometric freedom.

formatfloat

minimum0

maximum1

Enabled booloptional

Enable or disable depth conditioning. Omit to use the model default.

Face FaceControloptional

Face-identity conditioning control

Enabled booloptional

Enable or disable face conditioning. Omit to use the model default.

Normals NormalsControloptional

Surface-normals conditioning control

Augmentation float64optional

Surface-normals augmentation from 0 to 1. Higher values allow more reinterpretation of surface geometry.

formatfloat

minimum0

maximum1

Enabled booloptional

Enable or disable normals conditioning. Omit to use the model default.

Pose PoseControloptional

Pose / skeleton conditioning control

Enabled booloptional

Enable or disable pose conditioning. Omit to use the model default.

Strength PoseControlStrengthoptional

Pose-conditioning strength

One of the following:

const PoseControlStrengthPrecise PoseControlStrength = "precise"

const PoseControlStrengthCoarse PoseControlStrength = "coarse"

Trajectory TrajectoryControloptional

Motion-trajectory conditioning control

Enabled booloptional

Enable or disable trajectory conditioning. Omit to use the model default.

Sparsity float64optional

Point-trajectory sparsity from 0 to 1. Higher values use fewer motion anchors.

formatfloat

minimum0

maximum1

type DepthControl struct{…}

Depth / scene-geometry conditioning control

Blur float64optional

Depth-map blur amount from 0 to 1. Higher values allow more geometric freedom.

formatfloat

minimum0

maximum1

Enabled booloptional

Enable or disable depth conditioning. Omit to use the model default.

type FaceControl struct{…}

Face-identity conditioning control

Enabled booloptional

Enable or disable face conditioning. Omit to use the model default.

type Generation struct{…}

Generation status and output

ID string

Generation identifier

formatuuid

CreatedAt string

Creation timestamp

Model Model

Model used

One of the following:

const ModelUni1 Model = "uni-1"

const ModelUni1Max Model = "uni-1-max"

const ModelRay3_2 Model = "ray-3.2"

State GenerationState

Current state of the generation

One of the following:

const GenerationStateQueued GenerationState = "queued"

const GenerationStateProcessing GenerationState = "processing"

const GenerationStateCompleted GenerationState = "completed"

const GenerationStateFailed GenerationState = "failed"

Type GenerationType

The kind of generation to perform

One of the following:

const GenerationTypeImage GenerationType = "image"

const GenerationTypeImageEdit GenerationType = "image_edit"

const GenerationTypeVideo GenerationType = "video"

const GenerationTypeVideoEdit GenerationType = "video_edit"

const GenerationTypeVideoReframe GenerationType = "video_reframe"

const GenerationTypeLayering GenerationType = "layering"

FailureCode GenerationFailureCodeoptional

Machine-readable failure code for programmatic handling

One of the following:

const GenerationFailureCodeContentModerated GenerationFailureCode = "content_moderated"

const GenerationFailureCodeGenerationFailed GenerationFailureCode = "generation_failed"

const GenerationFailureCodeBudgetExhausted GenerationFailureCode = "budget_exhausted"

const GenerationFailureCodeOutputNotFound GenerationFailureCode = "output_not_found"

const GenerationFailureCodeImageTooLarge GenerationFailureCode = "image_too_large"

const GenerationFailureCodeUnsupportedFormat GenerationFailureCode = "unsupported_format"

const GenerationFailureCodeCorruptInput GenerationFailureCode = "corrupt_input"

const GenerationFailureCodeInvalidRequest GenerationFailureCode = "invalid_request"

const GenerationFailureCodeRateLimited GenerationFailureCode = "rate_limited"

FailureReason stringoptional

Human-readable failure description

Output []GenerationOutputoptional

Generated outputs (populated on completion)

Type string

Media type (e.g. image, video)

URL string

Presigned URL (1hr expiry)

formaturi

Layer GenerationOutputLayeroptional

Per-layer semantics for a type=layering output

AlphaHint string

Edge treatment of the layer's transparency — soft (hair/fur/glass), hard (solid edges), or none (the opaque background)

Description string

Complete-element caption for the layer's content

Index int64

Layer position, front-to-back; the last layer is the background

Label string

Short (1-2 word) layer name

type GenerationFailureCode string