UOUODUO AI Gateway

API

Images

使用文本提示生成图像，兼容 OpenAI-style image generation 请求。

概述

Images 接口用于根据文本提示生成图像。不同图像模型对 `size`、`quality`、`style`、透明背景和返回格式的支持不同，上线前应先在小流量环境验证。

请求

`POST https://api.example.com/v1/images/generations`

Headers

Header	必需	说明
Authorization	✓	`Bearer $UOUODUO_API_KEY`
Content-Type	✓	`application/json`

Body 参数

参数	类型	必需	默认	说明
prompt	string	✓	-	图像描述
model	string	否	路由默认	图像模型 ID
n	integer	否	1	生成数量，通常 1 到 10
size	string	否	模型默认	`1024x1024`、`1536x1024`、`1024x1536` 等
background	string	否	auto	`transparent`、`opaque`、`auto`，需模型支持
moderation	string	否	auto	内容审核级别
quality	string	否	auto	图像质量，模型相关
style	string	否	-	风格，模型相关
response_format	string	否	b64_json	`url` 或 `b64_json`，取决于模型
user	string	否	-	终端用户标识

示例

curl https://api.example.com/v1/images/generations \
  -H "Authorization: Bearer $UOUODUO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "一张展示 API 网关路由拓扑的简洁产品插图，浅色背景",
    "size": "1024x1024",
    "quality": "standard"
  }'

响应

字段	类型	说明
created	integer	创建时间
data	array<object>	图像结果列表
data[].b64_json	string	base64 图像数据
data[].url	string	临时图像 URL，若模型返回
data[].revised_prompt	string	模型改写后的 prompt，若返回
usage	object	部分模型返回 token 统计

{
  "created": 1779483000,
  "data": [
    { "b64_json": "..." }
  ],
  "usage": {
    "total_tokens": 100,
    "input_tokens": 50,
    "output_tokens": 50
  }
}

错误

HTTP	说明	处理建议
400	prompt 为空、size 不支持或参数与模型不兼容	按模型能力调整
401	API key 无效	重新创建 key
413	prompt 或图片输入过大	压缩或缩短
429	图像模型限流	降低并发或排队

注意事项

URL 返回通常是临时地址，生产系统应下载后存入自己的对象存储。
图像生成成本波动较大，建议给单独 API key 设置预算。
如果需要图像编辑，请确认所选模型是否开放 `/v1/images/edits`。