前言
青萍AI图床除了基础的图片管理和 CDN 分发能力，还提供了 AI 生图接口，支持文生图和图生图两种方式。
接口采用 RESTful 风格，请求和响应均为 JSON 格式。认证方式为请求头携带 API Key。
认证
所有接口需要在请求头中携带 X-API-KEY：
1
| X-API-KEY: your-api-key-here
|
API Key 在用户后台的 个人信息 页面获取。
创建会话
在生图之前，先创建一个会话。会话用来组织和管理生图任务，后续的文生图和图生图请求都挂载到同一个会话下。
请求
1
| POST /api/ai-chat/sessions
|
请求参数
1
2
3
| {
"title": "测试api生成会话"
}
|
| 参数 |
类型 |
必填 |
说明 |
| title |
string |
是 |
会话标题，用于区分不同的生图任务 |
响应示例
1
2
3
4
5
| {
"session_id": "session_81288c923af9",
"title": "测试api生成会话",
"created_at": "2026-07-08T12:00:00Z"
}
|
session_id 是后续文生图和图生图请求的必填参数，需要保存下来。
文生图
根据文本提示词生成图片。
请求
1
| POST /api/ai-chat/generate-text-to-image
|
请求参数
1
2
3
4
5
6
7
8
| {
"session_id": "session_d6d8bc43b761",
"prompt": "一只橘猫坐在窗台上，夕阳洒在它身上",
"image_size": "auto",
"image_resolution": "1K",
"image_count": 1,
"model": "nano-banana-2"
}
|
| 参数 |
类型 |
必填 |
说明 |
| session_id |
string |
是 |
创建会话时返回的会话 ID |
| prompt |
string |
是 |
图片描述提示词 |
| image_size |
string |
否 |
图片比例：auto（自动）、1:1、16:9、9:16、4:3、3:4 |
| image_resolution |
string |
否 |
输出分辨率：1K、2K、4K |
| image_count |
integer |
否 |
生成图片数量，默认 1，最大 4 |
| model |
string |
是 |
生图模型：nano-banana、nano-banana-2、nano-banana-pro |
响应示例
1
2
3
4
5
6
7
8
9
| {
"success": true,
"data": {
"task_id": "task_ai_22ea54346830",
"status": "pending",
"image_count": 1,
"message": "图片生成任务已创建"
}
}
|
接口返回后不代表图片已生成完成，需要用 task_id 轮询获取最终结果。
查询生成状态
轮询 GET /api/ai-chat/images/{task_id} 获取生成进度和结果。
1
| GET /api/ai-chat/images/task_a1b2c3d4
|
生成中响应
1
2
3
4
5
6
7
8
9
10
11
12
13
| {
"success": true,
"data": {
"task_id": "task_ai_22ea54346830",
"status": "processing",
"image_count": 1,
"images": [],
"generation_type": "text-to-image",
"prompt": "生成一张真人配音员招募的海报",
"image_size": "auto",
"source_image_url": null
}
}
|
生成完成响应
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
| {
"success": true,
"data": {
"task_id": "task_ai_22ea54346830",
"status": "completed",
"image_count": 1,
"images": [
{
"image_index": 0,
"status": "completed",
"image_id": 6914253,
"cdn_image_url": "https://img-cdn.lusyoe.cn/images/lusyoe/2026/07/08/muv540x7.jpg",
"oss_image_url": null,
"error_message": null
}
],
"generation_type": "text-to-image",
"prompt": "生成一张真人配音员招募的海报",
"image_size": "auto",
"source_image_url": null,
"created_at": "2026-07-08T20:07:49",
"updated_at": "2026-07-08T20:08:24"
}
}
|
推荐轮询间隔为 3-5 秒，直到 status 变为 completed 或 failed。
图生图
在文生图的基础上，传入一张或多张参考图片，让 AI 根据参考图的内容和风格生成新图。
适合的场景：给产品图换背景、根据线稿生成上色图、以某张图的风格生成新内容。
请求
1
| POST /api/ai-chat/generate-image-to-image
|
请求参数
1
2
3
4
5
6
7
8
9
10
11
| {
"session_id": "session_d6d8bc43b761",
"prompt": "将该产品放置在厨房环境中，使用自然的色彩和光线。确保产品保持真实比例，在场景中大小协调。产品需清晰可见并作为主要焦点，光影和反射效果真实自然。背景应与环境融合，但不能喧宾夺主，确保突出产品。",
"source_image_urls": [
"https://img-cdn.lusyoe.cn/images/lusyoe/2025/10/23/ej96myumf2.webp"
],
"image_size": "1:1",
"image_resolution": "1K",
"image_count": 1,
"model": "nano-banana-2"
}
|
| 参数 |
类型 |
必填 |
说明 |
| session_id |
string |
是 |
会话 ID |
| prompt |
string |
是 |
提示词，描述希望生成的画面 |
| source_image_urls |
array |
是 |
参考图片的 CDN URL 列表，至少传一张 |
| image_size |
string |
否 |
图片比例，同上 |
| image_resolution |
string |
否 |
输出分辨率：1K、2K、4K |
| image_count |
integer |
否 |
生成图片数量，默认 1，最大 4 |
| model |
string |
是 |
生图模型：nano-banana、nano-banana-2、nano-banana-pro |
响应示例
1
2
3
4
5
6
7
8
9
| {
"success": true,
"data": {
"task_id": "task_ai_22ea54346830",
"status": "pending",
"image_count": 1,
"message": "图片生成任务已创建"
}
}
|
生成的图片同样需要用 GET /api/ai-chat/images/{task_id} 轮询获取结果。
错误码
| HTTP 状态码 |
说明 |
| 200 |
请求成功 |
| 400 |
参数错误，缺少必填字段或格式不正确 |
| 401 |
API Key 无效或缺失 |
| 404 |
会话不存在或任务不存在 |
| 429 |
请求频率过高，请稍后重试 |
| 500 |
服务内部错误 |
完整调用示例
用 curl 完成一次文生图的完整流程：
创建会话
1
2
3
4
| curl -X POST https://img.lusyoe.com/api/ai-chat/sessions \
-H "Content-Type: application/json" \
-H "X-API-KEY: your-api-key" \
-d '{"title": "测试生图"}'
|
提交文生图任务
1
2
3
4
5
6
7
8
9
10
11
| curl -X POST https://img.lusyoe.com/api/ai-chat/generate-text-to-image \
-H "Content-Type: application/json" \
-H "X-API-KEY: your-api-key" \
-d '{
"session_id": "session_d6d8bc43b761",
"prompt": "一只橘猫坐在窗台上",
"image_size": "auto",
"image_resolution": "1K",
"image_count": 1,
"model": "nano-banana-2"
}'
|
轮询结果
1
2
| curl -H "X-API-KEY: your-api-key" \
https://img.lusyoe.com/api/ai-chat/images/task_a1b2c3d4
|
