Cancel a generation
Queued generations are canceled at no charge. Running generations are canceled at the
provider where supported; charges follow the model's cancel_policy.
bearerAuthAuthorizationBearer <token>API key, e.g. rf_live_3f9k2q_….
generation_id*string^gen_The generation after the cancel request was recorded.
application/json- response
object*unknownid*stringmodel*stringserved_by?|Model that actually ran (differs from model after a fallback).
type*MediaType"image""video"mode*GenerationMode"text_to_image""image_edit""text_to_video""image_to_video""reference_to_video""video_edit""video_extend"status*GenerationStatus"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.
int64charge_micros?|int64metadata?created_at*stringdate-timestarted_at?|date-timecompleted_at?|date-timecurl -X POST 'https://api.rawframe.dev/v1/generations/string/cancel'{ "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"}Update auto-recharge settings PUT
When enabled, the saved card is charged `amount_micros` whenever the available balance falls below `threshold_micros` (checked every minute). Enabling needs a card saved by a previous top-up (`payment_method_required` otherwise). Requires the `billing:write` scope.
Create a generation POST
Validates the request, reserves `price_estimate` credits, and queues the job. Returns `202` immediately.