Documentation

Use your own images

Upload an image, then reference it in any image_url override (or a template layer’s src) with its asset:<id> reference. The renderer resolves it from your account server-side, so you never need a public URL. You can also pass a base64 data:image/* URI directly.

Prefer a UI?

Manage your uploads and copy references under App → Assets.

Upload, list, and reference

Asset references

# 1. Upload a file (multipart). 'name' is optional.
curl -X POST https://yourdomain.com/api/uploads \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F '[email protected]' \
  -F 'name=hero shot'
# → 201 { "id": "...", "name": "hero shot", "reference": "asset:...", ... }

# 2. List your uploads to find their ids / references later
curl https://yourdomain.com/api/uploads \
  -H 'Authorization: Bearer YOUR_API_KEY'
# → { "uploads": [{ "id": "...", "name": "hero shot", "reference": "asset:..." }], "total": 1 }

# 3. Reference it when generating (works in image_url overrides and layer src)
{
  "templateId": "your-template-id",
  "layers": {
    "photo": { "image_url": "asset:PASTE_UPLOAD_ID" }
  }
}