JanuslySign up
API reference

Uploads

Upload reference media — images, video, or audio — and get back a URL that render requests accept as a reference.

POST/api/v1/uploads

Multipart form data. Returns { url } — the only URLs render requests accept in their reference*Urls arrays.

Request

FieldTypeDescription
kindrequired"image" | "video" | "audio"What the file is used as. Determines the accepted formats and size limit.
filerequiredbinaryThe media file itself.

Limits by kind

  • Images — JPEG, PNG, WebP · up to 30 MB
  • Videos — MP4, MOV · up to 50 MB
  • Audio — MP3, M4A, AAC, WAV, OGG, WebM · up to 30 MB

Example

curl
curl -X POST https://janusly.com/api/v1/uploads \
  -H "Authorization: Bearer $JANUSLY_API_KEY" \
  -F kind=image -F file=@product.jpg
response
{
  "url": "https://…/uploads/….jpg",
  "kind": "image",
  "contentType": "image/jpeg",
  "bytes": 482133
}

Uploads are limited to 20 per minute per account. Invalid form data, an unknown kind, an unsupported format, or an oversized file all return 422 invalid_request with the reason in the message — see Errors & limits. Use the returned URL in a render request.