generation

Generate an image (synchronous)

Developer-facing image generation. Synchronous: returns { imageUrl } directly — there is no job to poll. Also available at /v1/image and /v1/image/generate. Requires generate:image scope.

post/v1/images

Request

  • Base URL: https://varosity.ai/api
  • URL: https://varosity.ai/api/v1/images
  • Auth: HTTP bearer

Request body

promptstring required
modelstring

Image model ID from GET /v1/models (e.g. nano-banana, gemini-3-pro-image, gemini-3.1-flash-image, flux-1.1-pro, dall-e-3, ideogram-v3). 'modelId' is also accepted.

aspect_ratio'16:9' | '9:16' | '1:1' | '4:5' | '21:9'

'aspectRatio' is also accepted.

reference_image_urlstring uri
providerOptionsobject

Advanced per-model knobs (e.g. gpt-image-1 quality/background/outputFormat, flux outputFormat/safetyTolerance, ideogram/recraft style). Full field list per model: /docs/provider-options.

Response

Image generated

okboolean
imageUrlstring uri
modelstring
cost_centsnumber

What this image was charged, in cents. On the user's own provider key, the provider's price (may be fractional).

billing_mode'platform' | 'byok'

Changes

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