> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omniall.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# File upload API

> Upload files via multipart and reuse the returned CDN URL.

# File upload API

| Action | Method | Path |
| - | - | - |
| Upload file | `POST` | `/v1/files` |

**Host:** `https://api.omniall.ai` · Auth `Authorization: Bearer sk-...` · Content-Type `multipart/form-data`.

Body field: `file` (required). Typical size limit is **10MB** (subject to site config).

Response includes `id`, `object`, `url`, `filename`, `bytes`, `created_at`. Use the returned `url` as a reference in image / video / audio requests.

```bash theme={null}
curl --location --request POST 'https://api.omniall.ai/v1/files' \
  -H "Authorization: Bearer $API_KEY" \
  --form 'file=@"/path/to/demo.pdf"'
```

Full schema: **API Reference → Platform → File upload**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.