Media

Upload immutable images, video, or audio and get a CDN URL to use as provider input for characters, generations, and voices.

Before you can pass your own image, video, or audio to an operation — as a character reference, a generation input, or a voice-clone source — upload it here and use the returned CDN URL.

Upload media

PUT /v1/media/{assetId}

Stores one create-only asset in your API key’s namespace. assetId is a UUID you generate. Send the exact byte count in the required Content-Length header.

A successful upload returns 201. Reusing an asset ID for different content returns 409.

Using the returned URL

The response returns an immutable https://cdn.someone.app/... URL.