Image Generation API

Use image generation models through a single API on Onysoft AI Gateway: Seedream, Flux, Imagen, Nano Banana, Ideogram, Grok Imagine, GPT Image, Recraft and more.

bolt

This page is the image part of the Content Generation API.

All generation endpoints (video, image, audio, voice, music) use the same backend. The endpoint below is a semantic alias for image models — for full details, status lookup and the parameter matrix, see the video-api page.

Generate Image

POST /v1/image/generate

Starts an image generation task (asynchronous). Equivalent: POST /v1/video/generate

Quick Example (Text-to-Image)

cURL

curl -X POST https://api.onysoft.com/v1/image/generate \
  -H "Authorization: Bearer sk-ony-YOUR-KEY" \
  -d '{
    "model": "seedream/5-lite-text-to-image",
    "prompt": "A serene mountain lake at sunset, photorealistic",
    "aspect_ratio": "16:9"
  }'
            

Quick Example (Image-to-Image)

cURL

curl -X POST https://api.onysoft.com/v1/image/generate \
  -H "Authorization: Bearer sk-ony-YOUR-KEY" \
  -d '{
    "model": "seedream/4.5-edit-i2i",
    "prompt": "Change background to futuristic neon city",
    "image_url": "https://example.com/input.jpg",
    "aspect_ratio": "1:1"
  }'
            

Status Lookup

cURL

curl https://api.onysoft.com/v1/image/status/vtask_abc123 \
  -H "Authorization: Bearer sk-ony-YOUR-KEY"
            

Featured Image Models

Model	Provider	Type	Price (USD)
`seedream/5-lite-text-to-image`	ByteDance	t2i (cheap)	$0.041
`seedream/4.5-text-to-image`	ByteDance	t2i	$0.049
`seedream/4.5-edit-i2i`	ByteDance	i2i	$0.049
`google/imagen4-fast-t2i`	Google	t2i	$0.030
`google/imagen4-ultra-t2i`	Google	t2i ultra	$0.090
`google-nano-banana-2-1k`	Google	t2i	$0.060
`google-nano-banana-2-2k`	Google	t2i	$0.090
`google/nano-banana-edit-i2i`	Google	i2i	$0.030
`flux-2/pro-text-to-image`	BFL	t2i	$0.053
`flux-2/flex-text-to-image`	BFL	t2i flex	$0.180
`ideogram/v3-edit-quality-i2i`	Ideogram	i2i + mask	—
`grok-imagine/text-to-image-quality`	xAI	t2i (NSFW supported)	—
`gpt-image-2-text-to-image`	OpenAI	t2i	$0.120

Full list of all models: GET /v1/models or the Models page.

Provider-Specific Parameters

Each provider's internal parameter format differs. For the detailed mapping table, see video-api → Provider Parameter Matrix.