Image Generation OpenAI Compatible (Legacy)

For new integrations, use Image Generation and the unified /ai/v1/images/generations protocol for generation, task queries, Webhooks, and errors. The OpenAI-compatible and vendor adapter interfaces on this page remain available. Before calling a model, query the Model Schema API, select the protocol by the returned path, and read that entry’s request.schema; do not rely on array order.

Current model inventory

Provider	Model IDs
OpenAI	`gpt-image-2`, `gpt-image-2-free`, `gpt-image-1.5`, `gpt-image-1`, `gpt-image-1-mini`, `dall-e-3`, `dall-e-2`
Google Gemini	`gemini-3.1-flash-lite-image`, `gemini-3.1-flash-image`, `gemini-3-pro-image`, `gemini-3.1-flash-image-preview`, `gemini-3.1-flash-image-preview-free`, `gemini-3-pro-image-preview`, `gemini-2.5-flash-image`, `gemini-2.5-flash-image-preview`
Google Imagen	`imagen-4.0`, `imagen-4.0-fast-generate-001`, `imagen-4.0-generate-001`, `imagen-4.0-ultra-generate-001`, `imagen-4.0-ultra`
Qwen / Wan	`qwen-image-3.0`, `qwen-image-3.0-pro`, `qwen-image-2.0`, `qwen-image-2.0-pro`, `wan2.7-image`, `wan2.7-image-pro`, `qwen-image`, `qwen-image-edit`, `qwen-image-max`, `wan2.6-t2i`
GLM	`glm-image`
ByteDance	`doubao-seedream-5.0-pro`, `doubao-seedream-5.0-lite`, `doubao-seedream-4-5`, `doubao-seedream-4-0`
Microsoft	`mai-image-2.5-pro`, `mai-image-2.5`, `mai-image-2.5-flash`
Ideogram	`V3`, `V_2`, `V_2_TURBO`, `V_2A`, `V_2A_TURBO`, `V_1`, `V_1_TURBO`, `DESCRIBE`, `UPSCALE`
Stable Diffusion	`Stable-Diffusion-3-5-Large`
Baidu	`ernie-image-turbo`, `musesteamer-air-image`
Flux	`flux-2-flex`, `flux-2-pro`, `FLUX-1.1-pro`
Agnes	`agnes-image-2.1-flash`

This inventory shows models that are currently available. It does not mean that every model accepts the same fields. Select the endpoint by path in the model Schema response and read that entry’s request.schema.

API Interface

Request URL

POST https://aihubmix.com/v1/models/<model_path>/predictions

<model_path> is <provider/model_id>, for example, <openai/gpt-image-1.5>, <qianfan/qwen-image>.

Request Headers

Authorization: Bearer $AIHUBMIX_API_KEY
Content-Type: application/json

Request Parameters

General Parameters

Parameter	Type	Required	Description
prompt	string	Yes	Prompt words
size	string	No	Image size, supports `1K` (not supported in Doubao-4-5 series), `2K`, `4K`, `auto` (default). Qwen series supports: `5121024`, `768512`, `7681024`, `1024576`, `5761024`, `10241024` (default)
image	string	No	Reference image path
n	integer	No	Number of images to generate, supports 1-10, default is 1
quality	string	No	Rendering quality, supports `low`, `medium`, and `high`; higher quality takes longer time

OpenAI Model Parameters

Parameter	Type	Required	Description
input_fidelity	string	No	Fidelity, supports `high` and `low` (default)
moderation	string	No	Content moderation strictness, supports `auto` (default, standard filtering) and `low` (less filtering), not supported in image-to-image mode
output_format	string	No	Output image format, supports `png`, `jpeg` (default) , `webp`

Flux Model Parameters

Parameter	Type	Required	Description
safety_tolerance	integer	No	Audit leniency, higher values indicate more leniency. Range `0<=x<=5`, default value is `2`
aspect_ratio	string	No	Desired aspect ratio for the image, supports `16:9` (default), `1:1`, `4:3`
seed	integer	No	Random number seed
raw	boolean	No	Whether to enable raw mode for a more natural visual effect, default `false`

Qwen Model Parameters

Parameter	Type	Required	Description
watermark	boolean	No	Whether to add a watermark to the generated image, supports `true` (default) and `false`
seed	integer	No	Random number seed, range `[0,2147483647]`

Doubao Model Parameters

Parameter	Type	Required	Description
sequential_image_generation	string	No	Control whether to disable composite image functionality
sequential_image_generation_options	object	No	Composite image configuration, effective only when `sequential_image_generation` is `auto`. Currently supports `max_images`, range [1, 15], default value is 15
watermark	boolean	No	Whether to add a watermark to the generated image, supports `true` (default) and `false`
seed	integer	No	Random number seed, range [-1, 2147483647], default value is -1
response_format	string	No	Return format for the generated image, supports `url` (link valid for 24 hours after image generation, please download promptly) or `base64_json`

The actual number of images that can be generated is influenced not only by max_images but also by the number of reference images provided. The number of input reference images + the final number of generated images ≤ 15.

Usage Examples

OpenAI

curl https://aihubmix.com/v1/models/openai/gpt-image-1.5/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
    -d '{
  "input": {
    "prompt": "A deer drinking in the lake, Sakura petals falling, green and clean water, japanese temple, dappled sunlight, cinematic lighting, expansive view, peace",
    "size": "1024x1024",
    "n": 1,
    "quality": "high",
    "moderation": "low",
    "background": "auto"
  }
}'

curl https://aihubmix.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-1.5" \
  -F "prompt=Change the background to blue sky and white clouds." \
  -F "image=@test.png" \
  -F "size=1024x1024"

gpt-image-2

This is an OpenAI image editing model. Use the full model name gpt-image-2; image2 is not a valid model ID. When the endpoint returns b64_json, the examples below save it as edited.png.

curl.exe -sS -X POST "https://aihubmix.com/v1/images/edits" `
  -H "Authorization: Bearer YOUR_API_KEY" `
  -F "model=gpt-image-2" `
  -F "prompt=Change the background to blue sky and white clouds." `
  -F "image=@test.png" `
  -F "size=1024x1024" `
  -D headers.txt `
  -o response.json `
  -w "HTTP_CODE:%{http_code}`nTOTAL:%{time_total}`n"

$b64 = (Get-Content .\response.json -Raw | ConvertFrom-Json).data[0].b64_json
[IO.File]::WriteAllBytes(".\edited.png", [Convert]::FromBase64String($b64))

import { readFile, writeFile } from "node:fs/promises";

const apiKey = process.env.AIHUBMIX_API_KEY;
if (!apiKey) {
  throw new Error("Set AIHUBMIX_API_KEY first.");
}

const form = new FormData();
form.append("model", "gpt-image-2");
form.append("prompt", "Change the background to blue sky and white clouds.");
form.append("image", new Blob([await readFile("test.png")], { type: "image/png" }), "test.png");
form.append("size", "1024x1024");

const response = await fetch("https://aihubmix.com/v1/images/edits", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
  },
  body: form,
});

if (!response.ok) {
  throw new Error(`${response.status} ${await response.text()}`);
}

const result = (await response.json()) as {
  data: Array<{ b64_json: string }>;
};

await writeFile("edited.png", Buffer.from(result.data[0].b64_json, "base64"));

Google Imagen

curl https://aihubmix.com/v1/models/google/imagen-4.0-fast-generate-001/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
    -d '{
  "input": {
    "prompt": "A deer drinking in the lake, Sakura petals falling, green and clean water, japanese temple, dappled sunlight, cinematic lighting, expansive view, peace",
    "numberOfImages": 1
  }
}'

Qwen

curl https://aihubmix.com/v1/models/qianfan/qwen-image/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
  -d '{
    "input": {
      "prompt": "A beautiful sunset over a calm ocean",
      "refer_image": "",
      "n": 1,
      "size": "1024x1024",
      "watermark": false
    }
  }'

curl https://aihubmix.com/v1/models/qianfan/qwen-image-edit/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
    -d '{
  "input": {
    "prompt": "Put this bear sitting under the moon (represented by a light gray crescent outline on a white background), holding a guitar, with small stars and speech bubbles like 'Be Kind' floating around.",
    "image": "https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/4766809571/p999719.png",
    "n": 1,
    "size": "1024x1024",
    "watermark": false,
    "seed": 0
  }
}'

Doubao

curl https://aihubmix.com/v1/models/doubao/doubao-seedream-4-0/predictions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "input": {
      "prompt": "Interstellar, black hole, a vintage train bursting out of a black hole, vying for visual impact, cinematic blockbuster, apocalyptic feel, dynamic, contrasting colors, oc rendering, ray tracing, motion blur, depth of field, surrealism, deep blue, the scene is shaped by delicate rich color layers creating the subject and scene, realistic texture, the lighting effects of a dark background create an atmosphere, combining artistic fantasy, exaggerated wide-angle perspective, glare, reflection, extreme light and shadow, strong gravity, devouring",
      "size": "2K",
      "sequential_image_generation": "disabled",
      "stream": false,
      "response_format": "url",
      "watermark": true
    }
  }'

curl https://aihubmix.com/v1/models/doubao/doubao-seedream-4-5/predictions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "input": {
        "model": "doubao-seedream-4-5",
        "prompt": "Keep the model's pose and the flowing shape of the liquid clothing unchanged. Change the clothing material from silver metal to completely transparent clear water (or glass). Through the liquid flow, the model's skin details can be seen. The light and shadow change from reflection to refraction.",
        "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png",
        "size": "2K",
        "watermark": false
    }
  }'

curl https://aihubmix.com/v1/models/doubao/doubao-seedream-4-5/predictions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "input": {
        "model": "doubao-seedream-4-5",
        "prompt": "Change the clothing in image 1 to the clothing in image 2",
        "image": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png", "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png"],
        "sequential_image_generation": "disabled",
        "size": "2K",
        "watermark": false
    }
  }'

curl https://aihubmix.com/v1/models/doubao/doubao-seedream-4-5/predictions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "input": {
        "model": "doubao-seedream-4-5",
        "prompt": "Generate 3 images of a girl and a cow toy happily riding a roller coaster in an amusement park, covering morning, noon, and evening",
        "image": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_1.png", "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_2.png"],
        "sequential_image_generation": "auto",
        "sequential_image_generation_options": {
            "max_images": 3
        },
        "size": "2K",
        "watermark": false
    }
  }'

Flux

flux-2-flex and flux-2-pro are asynchronous endpoints, requiring a two-step request. This series is extremely fast, almost instantaneous.

FLUX One-Step Drawing

Ideogram V3

Versions below V3 (V_2, V_1, etc.) are old interfaces and are not supported.
The returned links require a proxy network to access.

curl https://aihubmix.com/v1/models/ideogram/V3/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
    -d '{
  "input": {
    "prompt": "A deer drinking in the lake, Sakura petals falling, green and clean water, japanese temple, dappled sunlight, cinematic lighting, expansive view, peace, in the style of Pixar 3D",
    "rendering_speed": "QUALITY",
    "aspect_ratio": "2x1"
  }
}'

Error Responses and Compatibility Error Codes

This section applies to the Legacy /v1/images/* endpoints on this page. The new /ai/v1/images/* endpoints use a separate image error contract. Handle the response structures and error codes of the two interfaces separately. A general error response from a Legacy image endpoint has the following structure. param is optional, and tid is usually appended to message instead of being returned as a separate field:

{
  "error": {
    "message": "prompt is required (tid: req_01K0ABCDEF)",
    "type": "Aihubmix_api_error",
    "param": "",
    "code": "prompt_missing"
  }
}

Submit HTTP 5xx error feedback

Only when a request returns HTTP 5xx, submit feedback and include the tid from message.

HTTP	`code`	`message`	Description
400	`protocol_not_supported`	`This model does not support the legacy protocol. Use POST /ai/v1/images/generations. See https://docs.aihubmix.com/cn/api/async-tasks`	The selected model does not support the Legacy image creation protocol
400	`invalid_image_request`	Dynamic sanitized request parsing error	The JSON or multipart image request could not be parsed
400	`prompt_missing`	`prompt is required`	A generations or edits request is missing a non-empty prompt
400	`size_not_supported`	`size not supported for this image model`	The selected model does not support the requested `size`
400	`prompt_too_long`	`prompt is too long`	The prompt exceeds the model’s limit
400	`n_not_within_range`	`invalid value of n`	`n` is outside the model’s allowed range
403	`insufficient_user_quota`	`Your account balance is insufficient. Please recharge your account to continue using the API.`	The account balance or API Key quota is insufficient

In addition to the stable compatibility error codes above, Legacy image endpoints may return other dynamic code values and sanitized message values from model providers and compatibility paths. These dynamic codes are an open set; clients must not treat codes outside the table as a stable enum. The tid in message is the request trace ID.

Last updated: 2026-09-01

Getting Started

Gateway Features

Model Capabilities

Protocol Reference

Platform Management

Privacy & Terms

Image Generation OpenAI Compatible (Legacy)

Current model inventory

API Interface

Request URL

Request Headers

Request Parameters

General Parameters

OpenAI Model Parameters

Flux Model Parameters

Qwen Model Parameters

Doubao Model Parameters

Usage Examples

OpenAI

gpt-image-2

Google Imagen

Qwen

Doubao

Flux

FLUX One-Step Drawing

Ideogram V3

Error Responses and Compatibility Error Codes

Submit HTTP 5xx error feedback

​Current model inventory

​API Interface

​Request URL

​Request Headers

​Request Parameters

​General Parameters

​OpenAI Model Parameters

​Flux Model Parameters

​Qwen Model Parameters

​Doubao Model Parameters

​Usage Examples

​OpenAI

​gpt-image-2

​Google Imagen

​Qwen

​Doubao

​Flux

​FLUX One-Step Drawing

​Ideogram V3

​Error Responses and Compatibility Error Codes

Submit HTTP 5xx error feedback

Current model inventory

API Interface

Request URL

Request Headers

Request Parameters

General Parameters

OpenAI Model Parameters

Flux Model Parameters

Qwen Model Parameters

Doubao Model Parameters

Usage Examples

OpenAI

gpt-image-2

Google Imagen

Qwen

Doubao

Flux

FLUX One-Step Drawing

Ideogram V3

Error Responses and Compatibility Error Codes