API Reference
AI 图像 API
POST
ai-image-api
ID 13
销豹 AI 图像 API 根据提示词与可选参考图生成图片,适合封面、素材与内容配图。
POST
https://apis.xiaobao.ink/api/image/create
概述
- 文生图
- 参考图(可选)
- 多比例/分辨率参数
适用场景
- 封面生成
- 营销配图
- 短视频素材
调用约定
- 网关 ·
https://apis.xiaobao.ink - 鉴权 · 请求携带
key(Query 或 JSON Body,以本接口为准) - 回包 · JSON;请同时校验业务码与 HTTP 状态,不要只看 200
鉴权
请求需携带平台 API Key(查询参数 key 或 JSON 字段 key,以本接口说明为准)。在控制台 API Key 管理 创建密钥。
POST https://apis.xiaobao.ink/api/image/create
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
请求示例
https://apis.xiaobao.ink/api/image/create?key=你的密钥
详细说明
请求HEADER:
| 名称 | 值 |
|---|---|
| Content-Type | application/json |
请求参数说明:
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| model | 是 | string | nano-banana-pro | 支持模型: nano-banana nano-banana-pro nano-banana-2 |
| prompt | 是 | string | 一只可爱的猫咪在草地上玩耍 | 提示词 |
| aspectRatio | 否 | string | auto | 输出图像比例,支持的比例: auto 1:1 16:9 9:16 4:3 3:4 3:2 2:3 5:4 4:5 21:9 默认 auto |
| imageSize | 否 | string | 1K | 支持模型: nano-banana-pro nano-banana-pro-vt nano-banana-pro-cl nano-banana-pro-vip(只支持1k,2k) nano-banana-pro-4k-vip(只支持4k) - 输出图像大小,支持的大小: 1K 2K 4K 默认 1K - 注意:分辨率越高,生成时间越长 |
| urls | 否 | array | ["https://example.com/example.png"] | 参考图URL |
| notify | 是 | string | https://xx.x.ocm | 回调地址 |
返回参数说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 状态信息 |
| data | array | 请求结果数据集 |
| - task_id | string | 任务ID |
| exec_time | float | 执行耗时 |
| user_ip | string | 客户端IP |
返回示例
{ "code": 0, "msg": "success", "data": { "task_id": "i44bcf50-f2d0-4c26-a467-26f2014a771b" }}
常见问题
AI 图像 API 怎么用?
提交 prompt、模型与可选 urls 参考图,按文档获取生成结果或任务结果。
支持参考图吗?
支持。传入公网图片 URL 列表即可走图生图类能力(以文档为准)。
如何设置尺寸?
使用 aspectRatio、imageSize 等参数,可选值见文档。
适合短视频吗?
适合生成封面与中间素材,再交给剪辑或发布流程。
鉴权方式?
平台 API Key。
想要「文案自动出 IP 封面」用哪个接口?
口播文案自动提炼标题并生成人物一致竖版封面,请用 IP 视频封面接口 /doc/55。
相关接口
完整控制台文档(含调试台):/doc/13