Media
Image, speech, video generation and speech-to-text transcription. A vendor adapter of proxium builds the provider request from the fields that each route names.
Generate speech
Converts text to audio with the speech provider of the model. proxium reserves the budget, builds the provider request and returns the audio bytes. If the model or tier resolves to more than one provider, proxium tries the next one when a provider fails, and `x-proxium-timeout-ms` limits the whole chain. The cache does not apply to this route.
Transcribe audio
Converts an audio file to text with the speech-to-text provider of the model. proxium reserves the budget, builds the provider request and returns the provider's answer. If the model or tier resolves to more than one provider, proxium tries the next one when a provider fails, and `x-proxium-timeout-ms` limits the whole chain. The cache does not apply to this route.
Generate an image
Generates one image with the image provider of the model. proxium reserves the budget, builds the provider request and returns the image in the OpenAI `b64_json` shape for each provider. The routing policy can resolve a tier name in `model`. If the model or tier resolves to more than one provider, proxium tries the next one when a provider fails, and `x-proxium-timeout-ms` limits the whole chain. The cache does not apply to this route.
List videos
Lists the videos of the project, newest first. The list holds the state that proxium last read. It does not ask the provider.
Create a video
Starts a video with the video provider of the model, in the shape of the OpenAI video API. proxium reserves the budget, records the video for the project and returns it with the status `queued`. Read its state with `GET /v1/videos/{id}`. If the model or tier resolves to more than one provider, proxium tries the next one when a provider refuses the request, and `x-proxium-timeout-ms` limits the whole chain.
Retrieve a video
Returns a video of the project. While the video is not finished, proxium reads its state from the provider, and the call uses one call slot of the budget. When the video is finished, proxium writes its usage row once, priced by its seconds.
Delete a video
Removes the video from the project's list. After this, proxium does not read or download it.
Download a video
Downloads a finished video of the project from the provider. Each download uses one call slot of the budget.
Download a video
Downloads a finished video from the provider and returns its bytes. Each download uses one call slot of the budget. This route has no `/v1` path.
Start a video
Starts a video operation at the video provider of the model, and returns the operation name. Poll it with `/video/operations`. proxium records the call at this step. This route has no `/v1` path. If the model or tier resolves to more than one provider, proxium tries the next one when a provider refuses the submit, and `x-proxium-timeout-ms` limits the whole chain.
Poll a video
Reads the state of a video operation from the provider. Each poll uses one call slot of the budget. This route has no `/v1` path.