Upload an image

curl -X POST https://havincy.com/api/v1/uploads \
  -H "Authorization: Bearer $HAVINCY_API_KEY" \
  -F file=@product.png -F title="Product shot"

{
  "id": 5690,
  "object": "asset",
  "kind": "image",
  "status": "completed",
  "title": "Product shot",
  "credits": 0,
  "url": "https://havincy.com/rails/active_storage/blobs/proxy/.../product.png",
  "mime_type": "image/png"
}

Imports an image into the library (free, no credits) so you can reuse it as a reference in generations or Encore effects. Send either image_url (JSON) or file (multipart). The image type is detected from its bytes. Required permission: generate. MCP tool: upload_image.

string

Public https URL or data:image/...;base64, URI. JPEG, PNG or WEBP, max 10 MB.

file

Image file sent as multipart/form-data (alternative to image_url).

string

Title in the library (max 160 characters).

curl -X POST https://havincy.com/api/v1/uploads \
  -H "Authorization: Bearer $HAVINCY_API_KEY" \
  -F file=@product.png -F title="Product shot"

{
  "id": 5690,
  "object": "asset",
  "kind": "image",
  "status": "completed",
  "title": "Product shot",
  "credits": 0,
  "url": "https://havincy.com/rails/active_storage/blobs/proxy/.../product.png",
  "mime_type": "image/png"
}

curl -X POST https://havincy.com/api/v1/uploads \
  -H "Authorization: Bearer $HAVINCY_API_KEY" \
  -F file=@product.png -F title="Product shot"

{
  "id": 5690,
  "object": "asset",
  "kind": "image",
  "status": "completed",
  "title": "Product shot",
  "credits": 0,
  "url": "https://havincy.com/rails/active_storage/blobs/proxy/.../product.png",
  "mime_type": "image/png"
}

Assistant

Responses are generated using AI and may contain mistakes.

Assistant

Responses are generated using AI and may contain mistakes.

Overview

Account & models

Generation

Encore effects

Library & brand

Social publishing

Upload an image