Images

Generate images

Unavailable to free-plan accounts. Image count, size, format, and feature constraints vary by model; consult the endpoint guide.

post/images/generations

Request

  • Base URL: https://api.voidai.app/v1
  • URL: https://api.voidai.app/v1/images/generations
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Request body

modelstring required

Exact model ID from GET /models. Endpoint support and account eligibility are required.

promptstring required

Non-whitespace prompt. Model-dependent length limits apply.

ninteger
sizestring

Named size, auto, or custom WxH subject to gateway and model limits.

quality'low' | 'medium' | 'high' | 'auto' | 'standard' | 'hd'
output_format'png' | 'jpeg' | 'webp'
output_compressioninteger

Only valid for JPEG or WebP.

background'transparent' | 'opaque' | 'auto'

gpt-image-2 rejects transparent.

moderation'low' | 'auto'
seedinteger
streamboolean
partial_imagesinteger

Requires stream=true; streaming support depends on model/provider.

userstring
thinking'off' | 'low' | 'medium' | 'high'

Only supported for gpt-image-2 generation.

style'vivid' | 'natural'

Rejected by gpt-image* models.

response_format'url' | 'b64_json'

Rejected by gpt-image* models.

Response

Successful response.

idstring
creatednumber required

Changes

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