Images Generations 图片生成
根据文本描述生成图片,支持多种图片生成模型(通义万相、FLUX 等)。采用异步任务模式,提交后返回任务 ID,通过任务查询接口获取最终图片。
接口地址
POST /api/openai/imagesGenerations
请求头 Headers
| 名称 | 是否必须 | 说明 |
|---|
| Authorization | 是 | Bearer API_KEY |
| Content-Type | 是 | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|
| model | string | 是 | 图片生成模型名称,见下方支持模型 |
| prompt | string | 是 | 图片描述内容,越详细效果越好 |
| negative_prompt | string | 否 | 反向提示词,描述不希望出现的元素 |
| size | string | 否 | 图片尺寸,如 1024*1024,默认使用模型默认尺寸 |
| n | int | 否 | 生成数量,默认 1,最大 4 |
请求示例
{
"model": "wanx2.1-t2i-turbo",
"prompt": "未来城市夜景,赛博朋克风格,高清细节",
"negative_prompt": "模糊、低质量、水印",
"size": "1024*1024",
"n": 1
}
cURL 示例
curl https://api.hejushuzi.com/api/openai/imagesGenerations \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "wanx2.1-t2i-turbo",
"prompt": "未来城市夜景,赛博朋克风格,高清细节",
"size": "1024*1024",
"n": 1
}'
成功返回
{
"code": 200,
"msg": "success",
"data": {
"task_id": 15,
"status": "pending"
}
}
任务创建成功后,接口返回 task_id,需调用 Images Task 图片任务查询 接口轮询获取最终图片地址。
支持模型
| 模型 | 说明 | 价格 |
|---|
| wanx2.1-t2i-turbo | 通义万相 Turbo · 高速 | ¥0.40 / 张 |
| wanx2.1-t2i-plus | 通义万相 Plus · 高质量 | ¥0.60 / 张 |
| wanx2.2-t2i-plus | 通义万相 2.2 Plus · 旗舰 | ¥0.80 / 张 |
| wanx2.2-t2i-flash | 通义万相 2.2 Flash · 极速 | ¥0.30 / 张 |
| flux-dev | FLUX Dev · 通用开发版 | ¥0.50 / 张 |
| flux-schnell | FLUX Schnell · 极速版 | ¥0.20 / 张 |
计费说明
- 计费方式:按生成图片张数计费
- 费用 = 生成数量(n) × 模型单价
- 在任务创建时预扣费用,任务失败自动退还
- 生成数量 n > 1 时,费用按张数成倍计算
错误码
| code | 说明 |
|---|
| 400 | 参数错误(如 model/prompt 缺失、size 格式错误等) |
| 401 | API Key 无效或已过期 |
| 403 | 账户余额不足 |
| 429 | 请求频率超限,请稍后重试 |
| 500 | 图片生成服务内部错误 |
错误返回示例
{ "code": 400, "msg": "Model is required" }
{ "code": 401, "msg": "Invalid API Key" }
{ "code": 403, "msg": "Insufficient balance" }
{ "code": 429, "msg": "Rate limit exceeded" }