---
title: "Smart Route — recommend a model for a shot description"
method: POST
path: "/v1/route"
tags: ["routing"]
---

# Smart Route — recommend a model for a shot description

`POST /v1/route`

## Request

- Base URL: `https://varosity.ai/api`
- URL: `https://varosity.ai/api/v1/route`
- Auth: HTTP bearer

Takes a shot description and returns a ranked model recommendation filtered to the caller's configured BYOK keys and Credits balance. Free — no credits deducted.

## Request body

- object
  - `shot_description` string, required
  - `modality` 'video' | 'voice' | 'music' | 'image'
  - `duration_s` integer
  - `tier` 'draft' | 'standard' | 'premium'
  - `budget_cents` integer
  - `exclude_models` string[]

## Response `200`

Ranked recommendation with primary + fallbacks + filtered_out

## Other responses

- `401`: Unauthorized
- `422`: No models available with your current provider configuration

---

[API](https://skmtc.dev/varosity/apis/varosity-ai-api.md) · [All operations](https://skmtc.dev/varosity/apis/varosity-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/varosity/apis/varosity-ai-api/revisions/81d0169a4897?raw)