Upload Reference Image | Yeehoo Developers

Upload a reference image first, then pass the returned url in reference_images for image or video generation. Support and item limits follow the target model's schema.fields.

POST /v1/uploads/images

Overview

Item	Details
Authorization	`Authorization: Bearer sk_yeehoo_xxx`
Required scope	`v1:generate`
Request body	`multipart/form-data`
File field	`file`
Supported formats	PNG, JPEG, WebP, GIF
Response	`201 Created` + uploaded image metadata

The image is stored in the API Key's team workspace and region. The upload is not billed.

Example

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

Response

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

Use the returned URL in an image request:

{
  "model": "nano-banana-pro",
  "prompt": "Improve the details based on this reference image",
  "reference_images": ["https://files.aibubu.ai/uploads/global/user_xxx/reference.png"]
}