图像OpenAI 格式
生成图像
根据文本提示生成图像 — 完全兼容 OpenAI Images Generations API（DALL·E 2/3、gpt-image-1 等）
根据给定的文本提示创建图像。完全兼容 OpenAI Images Generations API，支持 dall-e-2、dall-e-3、gpt-image-1 系列等模型。
| 项目 | 值 |
|---|---|
| 请求方法 | POST |
| 请求路径 | /v1/images/generations |
| 完整 URL | https://api.amux.ai/v1/images/generations |
| 认证方式 | Authorization: Bearer <API_TOKEN> |
| 请求格式 | application/json |
| 响应格式 | application/json |
本接口完全对齐 OpenAI Images Generations 协议，可直接使用 OpenAI 官方 SDK 调用，仅需替换 Base URL 与 API Key。
请求体参数
Prop
Type
透传策略：amux-api 对未在上方列出的字段会原样透传至上游。例如：watermark / watermark_enabled（智谱 / 阿里通义）、user_id（阿里）、extra_body（Gemini Nano Banana 等渠道私有参数，从中读取 aspect_ratio / image_size / seed 等）等供应商专属字段也会被识别并透传到对应渠道。
请求示例
curl https://api.amux.ai/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $AMUX_API_KEY" \
-d '{
"model": "gpt-image-1",
"prompt": "一只戴着贝雷帽的可爱海獭幼崽，水彩风格",
"n": 1,
"size": "1024x1024",
"quality": "high",
"background": "transparent",
"output_format": "png"
}'import os
import base64
from openai import OpenAI
client = OpenAI(
base_url="https://api.amux.ai/v1",
api_key=os.environ["AMUX_API_KEY"],
)
response = client.images.generate(
model="gpt-image-1",
prompt="一只戴着贝雷帽的可爱海獭幼崽，水彩风格",
n=1,
size="1024x1024",
quality="high",
)
image_b64 = response.data[0].b64_json
with open("otter.png", "wb") as f:
f.write(base64.b64decode(image_b64))import { writeFileSync } from 'node:fs';
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.amux.ai/v1',
apiKey: process.env.AMUX_API_KEY,
});
const response = await client.images.generate({
model: 'gpt-image-1',
prompt: '一只戴着贝雷帽的可爱海獭幼崽，水彩风格',
n: 1,
size: '1024x1024',
quality: 'high',
});
const b64 = response.data![0].b64_json!;
writeFileSync('otter.png', Buffer.from(b64, 'base64'));响应示例
{
"created": 1730000000,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
"revised_prompt": "A watercolor illustration of a cute baby sea otter wearing a beret..."
}
],
"usage": {
"total_tokens": 1234,
"input_tokens": 28,
"output_tokens": 1206,
"input_tokens_details": {
"text_tokens": 28,
"image_tokens": 0
}
}
}响应字段
Prop
Type
ImageData 字段
Prop
Type
错误响应
{
"error": {
"message": "...",
"type": "invalid_request_error",
"param": "prompt",
"code": "invalid_value"
}
}| HTTP 状态码 | 含义 |
|---|---|
200 | 请求成功 |
400 | 请求参数错误（如 prompt 缺失、size 不支持等） |
401 | API 密钥无效或缺失 |
403 | 模型未授权或被内容安全策略阻止 |
404 | 模型不存在 |
429 | 触发速率限制或额度不足 |
500 / 502 / 503 | 服务端异常或上游不可用 |