media

Generate media with AI (video, image, or audio)

Generate a new media item from a text prompt: text-to-video, text-to-image, image-to-video, speech, music, or sound effects (generator 'auto' selects the supported model). Async — returns a media id that flips to ready when generation finishes; poll GET /media/:id or register a media.completed webhook. Priced on what the model actually costs; refused with 402 if your balance cannot cover the quote (see GET /me).

post/v1/media/generate

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/media/generate
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.cueframe.ai/api/auth/mcp/authorize, token URL https://api.cueframe.ai/api/auth/mcp/token, scopes: media:write)
    • API key in header PAYMENT-SIGNATURE

Request body

generator'text-to-video' | 'text-to-image' | 'image-to-video' | 'text-to-music' | 'text-to-speech' | 'text-to-sfx' | 'auto' required
promptstring required
styleobject

Free-form generation parameters, read per generator. All generators honor aspect (string) + durationSec (number) where applicable. text-to-speech honors voice (string; default voice when omitted), speed (number 0.7-1.2), stability (number 0-1), and styleExaggeration (number 0-1 → the endpoint's style exaggeration). Provider and model selection are server-owned and cannot be overridden.

Response

Generation enqueued.

idstring required
status'generating' required
estimateUsdnumber

Changes

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