图片创作接口文档
更新时间：2026-04-24
产品定价
| 模型 | 规格 | 参数设置 | 资源包扣减积分个数 |
|---|---|---|---|
| 标准模型 | 1k、2k | module: std aspect_resolution: 1k、2k |
1图片积分/张 |
| 标准模型 | 4k | module: std aspect_resolution: 4k |
2图片积分/张 |
| 专业模型 | 1080p、2k | module: pro aspect_resolution: 1080p、2k |
2视频积分/张 |
| 专业模型 | 4k | module: pro aspect_resolution: 4k |
3视频积分/张 |
接口说明
新增功能: 支持图片创作
接口调用域名：https://open.xiling.baidu.com
接口鉴权和通用字段说明请查阅：接口通用说明
图片创作接口采用异步任务模式。提交任务后返回一个或多个任务 ID，可通过查询接口轮询任务结果，也可通过回调地址接收任务完成通知。
图片创作积分仅支持本接口文档对应能力使用，不可用于其他接口。
接口列表
提交图片创作任务
POST /api/digitalhuman/open/v1/image-generate
Content-Type: application/json;charset=utf-8
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| prompt | string | 是 | 生成提示词，1000 字符以内 |
| reference_images | string[] | 否 | 参考图 URL 列表，最多 5 张（超出截取前 5 张），单张不超过 20MB；支持格式：jpg/jpeg/png/bmp/webp/gif；15~20MB 的图片会自动压缩 |
| generate_count | int | 否 | 生成数量，范围 1~4，默认 1 |
| image_quality | string | 否 | 图片质量，可选值：1K、2K、4K，默认 2K |
| image_ratio | string | 否 | 图片比例，可选值：1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9、21:9，默认 9:16 |
| module | string | 否 | 模型模块，可选值：std、pro，默认 std |
| enable_ai_watermark | bool | 否 | 是否开启AI水印，默认开启 |
| callback_url | string | 否 | 回调地址 |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| task_ids | string[] | 任务 ID 列表 |
请求示例
JSON
1{
2 "prompt": "A stylish Asian woman standing in a minimalist studio, soft daylight, commercial photography",
3 "generate_count": 2,
4 "image_quality": "2K",
5 "image_ratio": "9:16",
6 "module": "std"
7}返回示例
JSON
1{
2 "code": 0,
3 "message": {
4 "global": "success"
5 },
6 "result": {
7 "task_ids": [
8 "ig-sdusxe2fwxg2ete8v"
9 ]
10 }
11}回调参数
- task_type: image_generate
- data:
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| task_id | string | 是 | 子任务 ID |
| status | string | 是 | 状态：GENERATING（生成中）、SUCCEEDED（成功）、FAILED（失败） |
| image_url | string | 否 | 生成的图片地址，成功时返回 |
| thumbnail_url | string | 否 | 缩略图地址，成功时可返回 |
| error_message | string | 否 | 错误信息，失败时返回 |
回调示例
JSON
1{
2 "code": 0,
3 "msg": "ok",
4 "task_type": "image_generate",
5 "data": {
6 "task_id": "ig-sdusxe2fwxg2ete8v",
7 "status": "SUCCEEDED",
8 "image_url": "https://xiling-dh.bj.bcebos.com/example/image.png",
9 "error_message": ""
10 }
11}查询图片创作任务结果
GET /api/digitalhuman/open/v1/image-generate
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 任务 ID |
返回参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 子图片任务 ID |
| status | string | 是 | 状态：GENERATING（生成中）、SUCCEEDED（成功）、FAILED（失败） |
| image_url | string | 否 | 生成的图片地址 |
| thumbnail_url | string | 否 | 缩略图地址 |
| error_message | string | 否 | 错误信息 |
请求示例
Plain
1GET /api/digitalhuman/open/v1/image-generate?task_id=ig-sdusxe2fwxg2ete8v返回示例
JSON
1{
2 "code": 0,
3 "message": {
4 "global": "success"
5 },
6 "result": {
7 "task_id": "ig-sdusxe2fwxg2ete8v",
8 "status": "SUCCEEDED",
9 "image_url": "https://xiling-dh.bj.bcebos.com/example/image.png",
10 "thumbnail_url": "https://xiling-dh.bj.bcebos.com/example/thumb.png",
11 "error_message": ""
12 }
13}评价此篇文章