Endpoints
uploads
Was this page helpful?
Upload an owned product photo for server-side Image Ads requests.
POST
/api/v1/uploads
Upload a product photo
Store one JPG, PNG, or WebP product photo under the API-key account. The returned HTTPS URL can be used in Image Ads requests only by that account.
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 |
|---|---|---|---|
| base64 | string | Yes | Raw base64 image bytes or an image data URL, at most 10 MB after decoding. |
Responses
- 201
- Owned product photo 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
- 429
- Too many requests
- 502
- Job could not be started
- 503
- Models or rate limiting are temporarily unavailable