Generations

Get a generation

Returns one generation. Poll it every 10 seconds while status is processing; output.url is set once ready.

get/generations/{id}

Request

  • Base URL: https://api.cut.pro/api/v1
  • URL: https://api.cut.pro/api/v1/generations/{id}
  • Auth: API key in header X-Api-Key

Path parameters

idstring required

Response

Response for status 200

idstring required
kind'image' | 'video' required
status'processing' | 'ready' | 'failed' required

processing until it ends ready or failed; a failed one gives the credits back.

modelstring required
model_namestring required
mode'text' | 'image' | 'frames' | 'references' required

text: from the prompt alone. image: animates one image, the first frame (video only). frames: goes from a first to a last image (video only). references: borrows a person, product or style from the images, or edits them (image).

resolutionstring nullable required
secondsnumber nullable required
aspect_ratio'21:9' | '16:9' | '3:2' | '4:3' | '5:4' | '1:1' | '4:5' | '3:4' | '2:3' | '9:16' required
promptstring nullable required
image_idsstring[] required
credits_chargednumber required
error_code'MEDIA_REJECTED' | 'COPYRIGHT_BLOCKED' | 'REAL_FACES_BLOCKED' | 'SAFETY_BLOCKED' | 'MEDIA_FAILED' | 'MEDIA_UNAVAILABLE' | 'INSUFFICIENT_CREDITS' | 'TIMEOUT' | 'OUTPUT_CHECK_FAILED' nullable required
edit_idstring nullable required

Set on a ready video: pass it to POST /posts to publish or schedule it.

expected_secondsnumber nullable required

How long this model usually takes, while processing.

created_atstring required

Changes

No recorded changes to this operation across all 1 revision of this API.