Create Image Generation - 生成图片

更新时间：2026-08-13 10:47:55

功能说明

图片生成/编辑接口。同步模型直接返回图片结果；异步任务返回任务 ID 后通过 /api/v1/tasks/{task_id} 查询，X-Async 可省略。

调用说明

接口约束

调用者需要拥有 API Key，详情请参见管理 AI API Key。

请求路径

POST https://ai-api-cn.oceanbase.com/api/v1/images/generations

请求头

名称	是否必选	示例值	描述
Authorization	是	Bearer YOUR_API_KEY	鉴权信息
Content-Type	否	application/json	请求体格式
X-Async	否		历史兼容参数；新接入无需设置，服务会根据模型类型自动决定同步或异步返回，该 header 不再用于强制切换模式。

请求参数

Path 参数

名称	类型	是否必填	示例值	描述
无				此接口无 Path 参数。

Query 参数

名称	类型	是否必填	示例值	描述
无				此接口无 Query 参数。

Body 参数

名称	类型	是否必填	示例值	描述
model	string	是		模型名称

厂商特定参数说明

不同厂商的图像生成模型请求参数存在差异，请参考对应厂商的文档获取详细参数说明：

火山引擎：请参考火山引擎图像生成 API 文档
阿里云百炼：请参考阿里云百炼模型 API 文档

返回结果

返回参数

名称	类型	描述
success	boolean	请求是否成功
code	string	返回码
message	string	返回信息
data	object	业务返回数据

data 字段说明

名称	类型	描述
根据具体响应而定	unknown	成功响应数据，可能是图片结果或任务ID等信息。

请求示例

通义万象（qwen-image-2.0）

qwen-image-2.0 请求体使用 input.messages + parameters 结构，不能使用 GPT Image 的顶层 prompt/size/n。

curl --request POST 'https://ai-api-cn.oceanbase.com/api/v1/images/generations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image-2.0",
    "input": {
      "messages": [{
        "role": "user",
        "content": [{"text": "一只红色苹果放在白色桌面上，写实摄影"}]
      }]
    },
    "parameters": {
      "size": "1024*1024",
      "watermark": false
    }
  }'

返回示例

成功响应 (200)

同步模型直接返回 data；异步模型返回 task_id 和 task_status，可通过 /api/v1/tasks/{task_id} 查询结果。

{
  "success": true,
  "code": "200",
  "message": "successful",
  "data": {
    // 具体返回数据根据模型类型（同步/异步）而定
  }
}

请求参数错误 (400)

{
  "success": false,
  "code": "400",
  "message": "Invalid request parameters"
}

未鉴权 (401)

{
  "success": false,
  "code": "401",
  "message": "Unauthorized"
}

请求频率超限 (429)

{
  "success": false,
  "code": "429",
  "message": "Rate limit exceeded"
}