上传参考图 | Yeehoo Developers

先上传参考图，再将返回的 url 填入图片或视频任务的 reference_images。是否支持参考图及数量上限以目标模型的 schema.fields 为准。

POST /v1/uploads/images

接口概览

项	说明
鉴权	`Authorization: Bearer sk_yeehoo_xxx`
权限	`v1:generate`
请求体	`multipart/form-data`
文件字段	`file`
支持格式	PNG、JPEG、WebP、GIF
返回	`201 Created` + 图片资源信息

上传内容会按 API Key 所属团队工作空间和区域存储，并记录来源 API Key。接口不扣积分。

示例

curl -X POST https://aibubu.cn/v1/uploads/images \
  -H "Authorization: Bearer sk_yeehoo_your_api_key" \
  -F "file=@./reference.png"

响应

{
  "asset_id": "asset_01jxyz...",
  "url": "https://files.aibubu.cn/uploads/cn/user_xxx/reference.png",
  "content_type": "image/png",
  "size": 5074444,
  "width": 2048,
  "height": 2048
}

将 url 用于图生图：

{
  "model": "gpt-image-2",
  "prompt": "基于参考图优化画面细节",
  "reference_images": ["https://files.aibubu.cn/uploads/cn/user_xxx/reference.png"]
}

请使用返回的 URL

请使用接口返回的 url，不要依赖对象存储内部路径或自行拼接资源地址。