Para una integración nueva, usa Generación de imágenes con el protocolo unificado
/ai/v1/images/generations. Las interfaces compatibles de esta página siguen disponibles. Consulta la API Schema del modelo, selecciona el endpoint por path y lee su request.schema sin depender del orden del array.Inventario actual de modelos
| Proveedor | ID de modelos |
|---|---|
| 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 |
Este inventario indica los modelos disponibles actualmente. No significa que todos acepten los mismos campos. Selecciona el endpoint por
path en el Schema del modelo y lee su request.schema.API
Interfaz de la API
URL de la solicitud
POST https://aihubmix.com/v1/models/<model_path>/predictions
<model_path> es <provider/model_id>, por ejemplo, <openai/gpt-image-1.5>, <qianfan/qwen-image>.
Cabeceras de la solicitud
Authorization: Bearer $AIHUBMIX_API_KEY
Content-Type: application/json
Parámetros de la solicitud
Parámetros generales
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| prompt | string | Sí | Palabras del prompt |
| size | string | No | Tamaño de la imagen; admite 1K (no admitido en la serie Doubao-4-5), 2K, 4K, auto (predeterminado). La serie Qwen admite: 512*1024, 768*512, 768*1024, 1024*576, 576*1024, 1024*1024 (predeterminado) |
| image | string | No | Ruta de la imagen de referencia |
| n | integer | No | Número de imágenes a generar; admite 1-10, predeterminado 1 |
| quality | string | No | Calidad de renderizado; admite low, medium y high; una mayor calidad requiere más tiempo |
Parámetros para modelos de OpenAI
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| input_fidelity | string | No | Fidelidad; admite high y low (predeterminado) |
| moderation | string | No | Rigor de la moderación del contenido; admite auto (predeterminado, filtrado estándar) y low (menos filtrado); no se admite en el modo imagen a imagen |
| output_format | string | No | Formato de la imagen de salida; admite png, jpeg (predeterminado), webp |
Parámetros para modelos Flux
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| safety_tolerance | integer | No | Indulgencia de la auditoría; valores más altos indican más indulgencia. Rango 0<=x<=5, valor predeterminado 2 |
| aspect_ratio | string | No | Relación de aspecto deseada para la imagen; admite 16:9 (predeterminado), 1:1, 4:3 |
| seed | integer | No | Semilla del número aleatorio |
| raw | boolean | No | Si se habilita el modo raw para un efecto visual más natural; predeterminado false |
Parámetros para modelos Qwen
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| watermark | boolean | No | Si se añade una marca de agua a la imagen generada; admite true (predeterminado) y false |
| seed | integer | No | Semilla del número aleatorio; rango [0,2147483647] |
Parámetros para modelos Doubao
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| sequential_image_generation | string | No | Controla si se desactiva la funcionalidad de imagen compuesta |
| sequential_image_generation_options | object | No | Configuración de imagen compuesta; surte efecto solo cuando sequential_image_generation es auto. Actualmente admite max_images, rango [1, 15], valor predeterminado 15 |
| watermark | boolean | No | Si se añade una marca de agua a la imagen generada; admite true (predeterminado) y false |
| seed | integer | No | Semilla del número aleatorio; rango [-1, 2147483647], valor predeterminado -1 |
| response_format | string | No | Formato de retorno de la imagen generada; admite url (enlace válido durante 24 horas después de generar la imagen; descárgala a tiempo) o base64_json |
El número real de imágenes que se pueden generar está influenciado no solo por
max_images, sino también por el número de imágenes de referencia proporcionadas. El número de imágenes de referencia de entrada + el número final de imágenes generadas ≤ 15.Ejemplos de uso
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
Este es un modelo de edición de imágenes de OpenAI. Usa el nombre completogpt-image-2; image2 no es un ID de modelo válido. Cuando el endpoint devuelve b64_json, los siguientes ejemplos guardan el resultado como 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=Cambia el fondo a cielo azul y nubes blancas." `
-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", "Cambia el fondo a cielo azul y nubes blancas.");
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-flexyflux-2-proson endpoints asíncronos que requieren una solicitud de dos pasos. Esta serie es extremadamente rápida, casi instantánea.
Dibujo de un paso con FLUX
Dibujo asíncrono con Flux
Paso 1: Enviar la solicitud de dibujo Ejemplo de resultado de salida:{
"output": [
{
"taskId": "api.us1.***",
"polling_url": "https://api.us1.bfl.ai/v1/get_result?id=f9821dbf-f134-41c2-aaa8-5405fb665c76"
}
]
}
Get Image
curl https://api.aihubmix.com/v1/tasks/<taskId> \
-H "Authorization: Bearer sk-***" \
-X GET
Ideogram V3
- Las versiones inferiores a V3 (V_2, V_1, etc.) son interfaces antiguas y no son compatibles.
- Los enlaces devueltos requieren una red proxy para acceder.
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"
}
}'