---
title: "Create Image Generation - 生成图片 - OB Cloud 云数据库 master | OceanBase 文档中心"
description: "Create Image Generation - 生成图片 功能说明 图片生成/编辑接口。同步模型直接返回图片结果；异步任务返回任务 ID 后通过 /api/v1/tasks/{task_id} 查询， X-Async 可省略。 调用说明 接口约束 调用者需要拥有 API Key，详情请参见 管理 AI API K…"
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*qbZXRo_94ZEAAAAAAAAAAAAADiGDAQ/original) OB Cloud 云数据库

# Create Image Generation - 生成图片

更新时间：2026-06-16 17:57:45

## 功能说明

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

## 调用说明

### 接口约束

- 调用者需要拥有 API Key，详情请参见 [管理 AI API Key](https://www.oceanbase.com/docs/common-oceanbase-cloud-1000000005766992)。

### 请求路径

`POST {BASE_URL}/api/v1/images/generations`

### 请求头

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

## 请求参数

### Path 参数

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

### Query 参数

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

### Body 参数

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

### 厂商特定参数说明

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

- **火山引擎**：请参考 [火山引擎图像生成 API 文档](https://www.volcengine.com/docs/82379/1541523?lang=zh)
 - **阿里云百炼**：请参考 [阿里云百炼模型 API 文档](https://bailian.console.aliyun.com/cn-beijing/?tab=api#/api/?type=model&url=2975126)

## 返回结果

### 返回参数

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

### data 字段说明

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

## 请求示例

```bash
curl --request POST '{BASE_URL}/api/v1/images/generations' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "your-model-name"
  }'

```

## 返回示例

**成功响应 (200)**

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

```

**请求参数错误 (400)**

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

```

**未鉴权 (401)**

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

```

**请求频率超限 (429)**

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

```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线