Generate an image (6 or 10 tokens)

Text to image. Default model flux-schnell bills 6 tokens per image. model: nano-banana (10 tokens) follows style instructions more faithfully. With reference_urls (1–4 https images) the result is an EDIT that keeps the referenced character and product identical — the way to build a consistent storyboard; references force nano-banana. Tokens are spent before the provider call and refunded if it fails. Rate limited to 30/min per key.

post/v1/generate/image

Request

  • Base URL: https://api.ffmpeg-micro.com
  • URL: https://api.ffmpeg-micro.com/v1/generate/image
  • Auth: HTTP bearer

Request body

promptstring required
aspect'landscape_16_9' | 'portrait_9_16' | 'square_1_1'
model'flux-schnell' | 'nano-banana'

Ignored when reference_urls is given (references force nano-banana)

reference_urlsstring[]

https images the result must stay faithful to (a character sheet, a product shot)

seedinteger

Fixed seed for repeatability. Omit for random; null is rejected.

Response

Image generated

urlstring uri
aspectstring
model'flux-schnell' | 'nano-banana'
tokens_chargednumber

Example response

{
  "tokens_charged": 6
}

Changes

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