跳到正文
平台 / 文档 / AI 图像 API

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-Typeapplication/json

请求参数说明:

名称必填类型示例值说明
model是stringnano-banana-pro

支持模型:

nano-banana

nano-banana-pro

nano-banana-2

prompt是string一只可爱的猫咪在草地上玩耍


提示词


aspectRatio否stringauto

输出图像比例,支持的比例:

auto

1:1

16:9

9:16

4:3

3:4

3:2

2:3

5:4

4:5

21:9

默认 auto

imageSize否string1K

支持模型:

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是stringhttps://xx.x.ocm回调地址

返回参数说明:

名称类型说明
codeint状态码
msgstring状态信息
dataarray请求结果数据集
- task_idstring任务ID
exec_timefloat执行耗时
user_ipstring客户端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