Start a generation. Spends credits. 202 while it runs (poll GET /v1/generations/{id}?wait=45), 200 when the tool answers synchronously. Supports Idempotency-Key.

Changed on
post/v1/generations

Request

  • Base URL: https://api.lumeta.ai
  • URL: https://api.lumeta.ai/v1/generations
  • Auth: HTTP bearer

Request body

modelstring required

Model id or slug.

inputobject required

The model's inputs; schema at GET /v1/models/{model}/schema. A choice listed in a field's x-lumeta-option-min-plan above your plan answers 403 plan_required and charges nothing.

projectstring

proj_<id> to file the generation in (default: your current project).

Response

OK

idstring
status'queued' | 'processing' | 'succeeded' | 'failed'
status_messagestring nullable

While status is queued or processing, one plain sentence on what the generation is waiting on, when there is a long wait worth telling the person about (today: Seedance clearing new face photos, which can take several minutes, the photos waiting in line while Seedance's face library is busy, a slow hand-over to Seedance, or the safety check after Seedance did not answer). It changes as the wait moves on, and is null otherwise and once the generation has finished. Show it as it is.

projectstring nullable
inputobject
textstring nullable

The words of a model that answers in text rather than a file, such as Speech-to-Text's transcript (its outputs is empty); null otherwise.

credits_chargedinteger

What was charged; a refunded failure reads 0.

origin'web' | 'api' | 'mcp' | 'cli'
request_idstring nullable
created_atstring
completed_in_secondsnumber nullable
credits_remaininginteger

On POST /v1/generations only.

cap_remaininginteger nullable

Changes