Media

Start media generation

Starts durable media generation from an unexpired estimate. Reuse the same Idempotency-Key to safely recover a lost response. An account can have at most 5 generations in progress; further starts return 429 (retryable) until one finishes. Provider failures return 502 and are not retried with the same estimate.

post/v1/media/generations

Request

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

Headers

Idempotency-Keystring required

Request body

estimate_idstring uuid required
overwriteboolean

With save_to: replace a project file that already has an output's path.

save_tostring

Keep the outputs as files of the key's Cloud project: a file path, or a prefix ending in / to save every output under it. Saved files are stored and charged like uploads. A deployed project's key keeps them under artifacts/ when this is omitted.

Response

Successful response.

completedboolean required
completed_atstring date-time nullable required
created_atstring date-time required
idstring uuid required
media_kind'audio' | 'file' | 'image' | 'video' required
modelstring required
object'media.generation' required
status'failed' | 'output_ready' | 'reserved' | 'running' | 'settled' | 'settlement_pending' | 'submitted' | 'submitting' | 'submission_uncertain' required
updated_atstring date-time required

Changes

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