Endpoints
Uploads (photos, videos, audio)
Was this page helpful?
Upload owned photos, videos, and audio for model reference inputs.
POST
/api/v1/uploads
Upload a photo, video, or audio reference
Store one magic-byte-checked JPG, PNG, or WebP image under the API-key account. The direct request-body cap is 4 MB; use sign, PUT, and verify for larger images, MP4, MP3, or WAV. Limited to 10 uploads per minute and 500 per day per key.
Authentication: Bearer API key required
curl -X POST "https://reviral.ai/api/v1/uploads" \
-H "Authorization: Bearer $REVIRAL_API_KEY"Request body
| Field | Type | Required | Description |
|---|---|---|---|
| kind | value | No | — |
| base64 | string | Yes | Raw base64 image bytes or an image data URL, at most 4 MB after decoding. |
Responses
- 201
- Owned reference stored
- 400
- Body is empty or is not JSON
- 401
- Key is missing, revoked, or invalid
- 413
- Settings are invalid or a reference field is unsupported
- 415
- Settings are invalid or a reference field is unsupported
- 422
- Settings are invalid or a reference field is unsupported
- 429
- Too many requests
- 502
- Job could not be started
- 503
- Models or rate limiting are temporarily unavailable