上传素材

不要在生成请求中传递 base64 素材。请先上传文件，再将返回的 data.url 填入目标模型对应的参考素材字段。

对外素材上传接口

所有接口使用 multipart/form-data 的 file 字段和你的 API Key。上传成功后，请将返回的 data.url 原样用于后续生成请求。

通道	对外地址
图片渠道1	`POST https://tu.baoliu.love/v1/uploads/images`
图片渠道2	`POST https://tu.baoliu.love/v1/uploads/images-2`
视频渠道1	`POST https://tu.baoliu.love/v1/uploads/videos`
音频渠道1	`POST https://tu.baoliu.love/v1/uploads/audio`

图片渠道1

POST https://tu.baoliu.love/v1/uploads/images

string

必填

Bearer YOUR_1788_API_KEY

file

必填

图片文件。支持 JPEG、PNG、WebP、GIF；最大 20 MB。

curl --request POST \
  --url https://tu.baoliu.love/v1/uploads/images \
  --header 'Authorization: Bearer YOUR_1788_API_KEY' \
  --form 'file=@/path/to/reference-image.png'

import requests

with open("reference-image.png", "rb") as image:
    response = requests.post(
        "https://tu.baoliu.love/v1/uploads/images",
        headers={"Authorization": "Bearer YOUR_1788_API_KEY"},
        files={"file": image},
    )

print(response.json())

const form = new FormData();
form.append("file", fileInput.files[0]);

const response = await fetch("https://tu.baoliu.love/v1/uploads/images", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_1788_API_KEY" },
  body: form,
});

console.log(await response.json());

图片上传成功响应

下面是图片渠道1的成功响应。

{
  "success": true,
  "message": "",
  "data": {
    "id": "media_0123456789abcdef0123456789abcdef01234567",
    "url": "https://tu.baoliu.love/v1/uploads/media_0123456789abcdef0123456789abcdef01234567/content.png",
    "mime_type": "image/png",
    "size": 235680
  }
}

string

图片 URL。将返回值原样放入目标模型的图片参考字段，例如 image_urls。

string

平台素材 ID。请使用 data.url，不要自行拼接 URL。

string

识别出的 MIME 类型，例如 image/png。

integer

文件大小，单位为字节。

图片渠道2

POST https://tu.baoliu.love/v1/uploads/images-2 图片格式、认证方式和成功响应与图片渠道1一致。

建议客户端同时接入图片渠道1和图片渠道2：先请求图片渠道1；当请求超时、网络异常或服务端返回 5xx 时，自动改用图片渠道2 上传同一个文件。参数校验或 API Key 错误等 4xx 响应无需切换，请直接修正请求后重试。

对外调用示例：

curl --request POST \
  --url https://tu.baoliu.love/v1/uploads/images-2 \
  --header 'Authorization: Bearer YOUR_1788_API_KEY' \
  --form 'file=@/path/to/reference-image.png'

视频渠道1

POST https://tu.baoliu.love/v1/uploads/videos

该接口用于上传参考视频。平台会返回可供生成渠道读取的 HTTPS URL；它不是长期素材存储，请在生成任务中及时使用。

string

必填

Bearer YOUR_1788_API_KEY。必须是平台中有效、可用的 API 令牌；未携带、无效或禁用的令牌不能上传。

file

必填

视频文件。支持 MP4、WebM、MOV；最大 50 MB。

curl --request POST \
  --url https://tu.baoliu.love/v1/uploads/videos \
  --header 'Authorization: Bearer YOUR_1788_API_KEY' \
  --form 'file=@/path/to/reference-video.mp4'

import requests

with open("reference-video.mp4", "rb") as video:
    response = requests.post(
        "https://tu.baoliu.love/v1/uploads/videos",
        headers={"Authorization": "Bearer YOUR_1788_API_KEY"},
        files={"file": video},
    )

print(response.json())

视频上传成功响应

{
  "success": true,
  "message": "",
  "data": {
    "id": "media_0123456789abcdef0123456789abcdef01234567",
    "url": "https://tu.baoliu.love/v1/uploads/media_0123456789abcdef0123456789abcdef01234567/content.mp4",
    "mime_type": "video/mp4",
    "size": 18438718
  }
}

string

可公网访问的视频 URL。将其原样填入目标模型的视频参考字段，例如 reference_videos。

string

平台素材 ID。请使用 data.url，不要自行拼接 URL。

string

识别出的 MIME 类型，例如 video/mp4。

integer

文件大小，单位为字节。

音频渠道1

POST https://tu.baoliu.love/v1/uploads/audio 该接口由平台 VPS 提供，用于需要公网音频 URL 的语音克隆流程。它与上面的三个素材通道独立。音频文件在 72 小时后清理，请及时用于后续任务。

string

必填

Bearer YOUR_1788_API_KEY

file

必填

音频文件。支持 MP3、WAV、M4A；最大 10 MB。也兼容使用字段名 audio 或 audio_file。

curl --request POST \
  --url https://tu.baoliu.love/v1/uploads/audio \
  --header 'Authorization: Bearer YOUR_1788_API_KEY' \
  --form 'file=@/path/to/reference-audio.mp3'

{
  "data": {
    "id": "audio_0123456789abcdef0123456789abcdef01234567",
    "url": "https://tu.baoliu.love/video/audio_0123456789abcdef0123456789abcdef01234567.mp3",
    "content_type": "audio/mpeg",
    "expires_at": 1785564000
  }
}

string

可公网读取的临时音频 URL。请原样填入语音克隆等后续接口的音频 URL 字段。

integer

URL 的预计清理时间，Unix 时间戳（秒）。

开始使用

API 参考

渠道对接

对外素材上传接口

图片渠道1

图片上传成功响应

图片渠道2

视频渠道1

视频上传成功响应

音频渠道1

​对外素材上传接口

​图片渠道1

​图片上传成功响应

​图片渠道2

​视频渠道1

​视频上传成功响应

​音频渠道1

对外素材上传接口

图片渠道1

图片上传成功响应

图片渠道2

视频渠道1

视频上传成功响应

音频渠道1