AIHub 在 https://ai.yunxinapi.com/hub/v1 下提供 OpenAI-compatible Images API，用于文生图与图片编辑。

图片生成与编辑当前按 非流式 请求处理。模型、尺寸、输出格式等字段是否生效，取决于所选上游渠道。

请求 URL

• 根据提示词生成图片：POST https://ai.yunxinapi.com/hub/v1/images/generations
• 根据参考图与提示词编辑图片（支持 JSON 与 multipart 请求体）：POST https://ai.yunxinapi.com/hub/v1/images/edits

请求头

Header	必填	说明
Authorization	是	AIHub 访问令牌，格式wei Bearer <AIHUB_TOKEN>
Content-Type	是	application/json（generations/JSON edits）或 multipart/form-data（multipart edits）

/v1/images/generations 请求体

字段	类型	必填	说明
model	string	是	AIHub 逻辑模型名称。
prompt	string	是	文生图提示词。
n	int	否	生成张数，默认 1。
size	string	否	图片尺寸，如 1024x1024；可用值取决于上游。
quality	string	否	图片质量，如 standard、hd；取决于模型。
response_format	string	否	返回格式：url 或 b64_json。
style	string	否	风格，如 vivid、natural；取决于模型。
user	string	否	终端用户标识，可能用于上游审计。
background	string	否	背景设置；部分新模型支持。
output_format	string	否	输出编码，如 png、webp；取决于模型。
moderation	string	否	内容审核级别；取决于上游。

/v1/images/edits 请求体

字段	类型	必填	说明
model	string	是	支持图片编辑的逻辑模型名。
prompt	string	是	编辑指令。
image	file/string	是	参考图片；multipart 时为文件字段，JSON 时可能为 data URL。
mask	file/string	否	蒙版图片，限定编辑区域。
n	int	否	生成张数。
size	string	否	输出尺寸。
response_format	string	否	url 或 b64_json。

multipart 请求时，image、mask 以表单文件字段上传；其余参数可作为表单字段传入。

请求示例

bashcurl "https://ai.yunxinapi.com/hub/v1/images/generations" \
  -H "Authorization: Bearer $AIHUB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "生成一张红色苹果放在木桌上的图片",
    "size": "1024x1024",
    "n": 1
  }'

成功响应

字段	类型	说明
created	int	Unix 时间戳。
data	object[]	生成结果列表。
data[].b64_json	string	Base64 图片内容（response_format=b64_json 时）。
data[].url	string	图片 URL（response_format=url 时，可能有时效）。
data[].revised_prompt	string	上游改写后的提示词；部分模型返回。

上游厂商参数映射

Images API 当前按 OpenAI-compatible 同协议转发；仅声明 images 能力的 OpenAI family 渠道参与路由。

目标上游/渠道类型	上游接口	AIHub 入参到上游参数	说明
OpenAI/OpenAI-compatible passthrough/backing gateway	POST https://ai.yunxinapi.com/hub/v1/images/generations 或 https://ai.yunxinapi.com/hub/v1/images/edits	model 映射为渠道上游模型名；prompt、size、n 等同名透传	同协议 managed 路由优先保留原始请求体
Azure OpenAI	Azure Images 路径	model 写为 deployment name；其余字段保持 OpenAI Images 语义	取决于 Azure 模型与 API 版本
Anthropic、DeepSeek、Moonshot 等非 Images 能力渠道	不适用	不路由，不做协议转换	请使用各厂商已声明的 Chat、generateContent 等入口

常见错误

场景	典型错误
模型未授权或未配置 images 渠道	model_not_found/路由失败。
不支持的 size 或字段组合	invalid_request_body/上游 4xx。