Uploads API
Preview source media upload endpoint.
Status: Preview — single-shot uploads are callable; resumable upload sessions are Planned.
Operation
| Endpoint | Description |
|---|---|
POST /v1/uploads | Upload one file up to 100MB and receive an artifact_id plus CDN URL. |
Use uploads when a generation request needs source material, such as reference audio for music. Store the returned artifact_id in your own job record.
Multipart form fields
| Field | Required | Notes |
|---|---|---|
file | Yes | The media file. |
purpose | No | Defaults to media_input; use reference_audio for music references. |
media_type | No | Inferred from MIME type when omitted. |
metadata | No | JSON object encoded as a form string. |