API referenceGenerations
Retrieve a generation
GET
Output URLs are freshly signed on every call and expire after outputs[].url_expires_at.
bearerAuthheader
AuthorizationBearer <token>API key, e.g. rf_live_3f9k2q_….
generation_id*stringMatch
^gen_The generation.
application/json- response
object*unknownid*stringmodel*stringserved_by?|Model that actually ran (differs from model after a fallback).
type*MediaTypeValue in
"image""video"mode*GenerationModeValue in
"text_to_image""image_edit""text_to_video""image_to_video""reference_to_video""video_edit""video_extend"status*GenerationStatusValue in
"queued""submitting""running""finalizing""succeeded""failed""canceled"prompt?stringparams?Normalized parameters. Unsupported values for the chosen model are rejected with invalid_parameters.
outputs?array<>error?|nullprice_estimate_micros*integerThe most this generation can cost, held from your balance until it finishes. With
routing.fallbacks, the highest estimate across the chain.
Format
int64charge_micros?|Format
int64metadata?created_at*stringFormat
date-timestarted_at?|Format
date-timecompleted_at?|Format
date-timecurl -X GET 'https://api.rawframe.dev/v1/generations/string'Example Response
{ "object": "generation", "id": "gen_01jbxa3m4n5p6q7r8s9t", "model": "string", "served_by": "string", "type": "image", "mode": "text_to_image", "status": "queued", "prompt": "string", "params": { "duration_seconds": 1, "aspect_ratio": "string", "resolution": "string", "num_outputs": 1, "seed": 0, "negative_prompt": "string", "audio": true, "output_format": "png" }, "outputs": [ { "id": "string", "kind": "image", "url": "http://example.com", "url_expires_at": "2019-08-24T14:15:22Z", "content_type": "string", "width": 0, "height": 0, "duration_seconds": 0, "has_audio": true, "size_bytes": 0, "expires_at": "2019-08-24T14:15:22Z" } ], "error": { "code": "content_rejected", "message": "string", "retryable": true }, "price_estimate_micros": 0, "charge_micros": 0, "metadata": { "property1": "string", "property2": "string" }, "created_at": "2019-08-24T14:15:22Z", "started_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z"}