Base Configuration

Base URL

Multimodal model requests are sent through the following base address:

https://odirouter.ai/model

Endpoint

{endpoint} is the model invocation identifier exposed by OdiRouter. Use the model ID directly. A complete create-task URL is:

POST {BASE_URL}/v1/queue/{endpoint}

Note

• endpoint must be a single path segment, such as nano_banana_2, wan26_i2v, or minimax_speech_28_turbo.
• Supported parameters vary by model. Use the model detail page and the examples in this documentation as the source of truth. Extra fields are rejected.
• The JSON body for a queue request does not need a model field.

Endpoint groups

Capability	Method	Path	Response style
Create task	POST	/model/v1/queue/{endpoint}	Queue request metadata
Check status	GET	/model/v1/queue/{endpoint}/requests/{request_id}/status	Current task status
Fetch result	GET	/model/v1/queue/{endpoint}/requests/{request_id}/response	Provider response after completion
Cancel task	PUT	/model/v1/queue/{endpoint}/requests/{request_id}/cancel	Cancel result when the endpoint supports it
Sora-style videos	POST	/v1/videos	Separate multipart video endpoint

Authentication

Requests use Bearer authentication:

Authorization: Bearer {apiKey}

Define common request headers with COMMON_HEADERS:

export BASE_URL="https://odirouter.ai/model"
export API_KEY="YOUR_API_KEY"

COMMON_HEADERS=(
  -H "Authorization: Bearer ${API_KEY}"
  -H "Content-Type: application/json"
)