大模型生图
更新时间：2025-12-14
本接口用于创建 AIGC 图片生成任务，采用 OpenAI 兼容格式，支持文生图和图生图。
注意事项：
- 仅支持一条 message
- 图生图仅 NB/NBP 模型支持
- NB 模型最多传入 3 张图片，NBP 模型最多传入 14 张图片
- NB/NBP 模型的 n 参数仅支持 1
- quality 参数仅 NBP 支持 2K/4K，其他模型仅支持 1K
请求结构
Http
1POST /v2/aigc/image HTTP/1.1
2connection: keep-alive
3host: vod.bj.baidubce.com
4content-type: application/json
5x-bce-request-id: <bce-request-id>
6x-bce-date: <utc-date-string>
7authorization: <bce-authorization-string>请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| model | string | 是 | 模型名称，支持：
|
| messages | Array<AIGCImageMessage> | 是 | 消息列表，仅支持一条消息 |
| n | integer | 否 | 生成图片数量，范围 1-4，NB/NBP 仅支持 1 |
| size | string | 否 | 图片宽高比，支持：1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 |
| quality | string | 否 | 图片分辨率，支持：1K, 2K, 4K（仅 NBP 支持 2K/4K） |
| response_modalities | Array |
否 | 响应模态，如传入必须包含 "IMAGE" |
| tools | Array<AIGCImageTool> | 否 | 工具定义，仅 NBP 支持，NB 不支持 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| taskId | string | 任务id |
模型能力对比
| 模型 | 图生图 | 传入最大图片数 | 生成最大图片数 | quality 支持 | tools 支持 |
|---|---|---|---|---|---|
| NB | ✅ | 3 张 | 仅 1 | 仅 1K | ❌ |
| NBP | ✅ | 14 张 | 仅 1 | 1K/2K/4K | ✅ |
| I4YG1 | ❌ | - | 1-4 | 仅 1K | ❌ |
| I4FG1 | ❌ | - | 1-4 | 仅 1K | ❌ |
| I4G1 | ❌ | - | 1-4 | 仅 1K | ❌ |
请求示例
文生图示例
请求内容
Http
1POST /v2/aigc/image HTTP/1.1
2host: vod.bj.baidubce.com
3accept: */*
4connection: keep-alive
5content-type: application/json
6x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
7x-bce-date: 2024-03-24T13:08:44Z
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
9
10{
11 "model": "NBP",
12 "messages": [
13 {
14 "role": "user",
15 "content": [
16 {
17 "type": "text",
18 "text": "一只可爱的猫咪在阳光下睡觉"
19 }
20 ]
21 }
22 ],
23 "n": 1,
24 "size": "1:1",
25 "quality": "2K"
26}返回内容
JSON
1{
2 "taskId": "tsk-xxxxxxxx"
3}图生图示例
请求内容
Http
1POST /v2/aigc/image HTTP/1.1
2host: vod.bj.baidubce.com
3accept: */*
4connection: keep-alive
5content-type: application/json
6x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d482
7x-bce-date: 2024-03-24T13:08:44Z
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
9
10{
11 "model": "NBP",
12 "messages": [
13 {
14 "role": "user",
15 "content": [
16 {
17 "type": "text",
18 "text": "把这张图片变成油画风格"
19 },
20 {
21 "type": "image_url",
22 "image_item": {
23 "image_url": "https://example.com/image.jpg"
24 }
25 }
26 ]
27 }
28 ],
29 "size": "1:1"
30}返回内容
JSON
1{
2 "taskId": "tsk-xxxxxxxx"
3}使用 tools 示例（仅 NBP）
请求内容
JSON
1{
2 "model": "NBP",
3 "messages": [
4 {
5 "role": "user",
6 "content": [
7 {
8 "type": "text",
9 "text": "搜索最新的科技新闻并生成一张相关图片"
10 }
11 ]
12 }
13 ],
14 "tools": [
15 {
16 "type": "function",
17 "function": {
18 "name": "GWebSearch",
19 "description": "网页搜索"
20 }
21 }
22 ]
23}错误码
| 错误信息 | 说明 |
|---|---|
| [InvalidParameter] messages: 不能为空 | messages 参数为空 |
| [InvalidParameter] messages: 仅支持一条消息 | messages 超过 1 条 |
| [InvalidParameter] messages: 必须包含至少一条文本内容 | 没有文本 prompt |
| [InvalidParameter] model: 当前模型不支持图生图 | 当前模型不支持图生图 |
| [InvalidParameter] messages: NB 模型最多支持传入 3 张图片 | NB 图片数超限 |
| [InvalidParameter] messages: NBP 模型最多支持传入 14 张图片 | NBP 图片数超限 |
| [InvalidParameter] quality: 仅 NBP 模型支持 2K/4K 分辨率 | 非 NBP 使用高分辨率 |
| [InvalidParameter] n: NB/NBP 模型仅支持生成 1 张图片 | NB/NBP 的 n > 1 |
| [InvalidParameter] tools: NB 模型不支持 tools 参数 | NB 使用 tools |
| [InvalidParameter] response_modalities: 必须包含 'IMAGE' | 响应模态缺少 IMAGE |