Route tasks to the best model automatically, via any OpenAI-compatible API.
Author: whatevername2023@proton.me
Models and provider are configured in models.json. Set two environment variables:
SMART_ROUTER_BASE_URL — OpenAI-compatible API base URL (e.g. https://api.openai.com/v1)SMART_ROUTER_API_KEY — API key for the providerEdit models.json to customize categories, models, and defaults for your provider.
Prefix a message with @alias to skip auto-classification and call a specific model directly.
Format: @alias your question or prompt here
| Alias | Model ID | Category |
|---|---|---|
| ------- | ---------- | ---------- |
| Vision | ||
@gpt4o | chatgpt-4o-latest | vision |
@qwen-vl | qwen3-vl-235b-a22b-instruct | vision |
@qwen-vl-max | qwen-vl-max-2025-08-13 | vision |
@llama-vl | llama-3.2-90b-vision-instruct | vision |
@qwen-vl-32b | qwen3-vl-32b-instruct | vision |
| Image Gen | ||
@imagen | google/imagen-4-ultra | image_gen |
@flux | black-forest-labs/flux-1.1-pro-ultra | image_gen |
@flux-kontext | black-forest-labs/flux-kontext-max | image_gen |
@dalle | dall-e-3 | image_gen |
@flux2 | flux-2-pro | image_gen |
| Video Gen | ||
@sora | sora-2-pro-all | video_gen |
@veo | veo3.1-pro-4k | video_gen |
@vidu | viduq3-pro | video_gen |
@kling | kling-video | video_gen |
@runway | runwayml-gen4_turbo-10 | video_gen |
| Audio | ||
@suno | suno_music | audio |
@tts | gemini-2.5-pro-preview-tts | audio |
@tts-hd | tts-1-hd | audio |
@kling-audio | kling-audio | audio |
@vidu-tts | vidu-tts | audio |
| Reasoning | ||
@o3 | o3 | reasoning |
@o3-pro | o3-pro | reasoning |
@o4-mini | o4-mini | reasoning |
@deepseek | deepseek-r1 | reasoning |
@gemini-think | gemini-2.5-pro-thinking | reasoning |
@claude-think | claude-sonnet-4-5-20250929-thinking | reasoning |
| Code | ||
@claude | claude-opus-4-6 | code |
@codex | gpt-5.1-codex-max | code |
@claude-sonnet | claude-sonnet-4-6 | code |
@qwen-coder | qwen3-coder-480b-a35b-instruct | code |
@qwen-coder-plus | qwen3-coder-plus | code |
@gpt4t | gpt-4-turbo | code |
| General | ||
@gpt52 / @gpt5 | gpt-5.2-chat-latest | general |
@gemini | gemini-2.5-pro | general |
@deepseekv3 | deepseek-v3.2 | general |
@qwen | qwen3-max | general |
@claude-chat | claude-opus-4-6 | general |
Aliases are case-insensitive. If no alias matches, attempt fuzzy match on model name/ID. If still no match, prompt the user.
When no @alias is specified, classify the task automatically:
| Category | Trigger |
|---|---|
| ---------- | --------- |
vision | User sends image/URL, asks to analyze, describe, OCR, understand image content |
image_gen | Requests to draw, generate image, design poster, create illustration |
video_gen | Requests to generate video, animation, text-to-video, image-to-video |
audio | Requests for music generation, TTS, sound effects |
reasoning | Complex math, logic puzzles, proofs, deep analysis, long-chain reasoning |
code | Code generation, debugging, refactoring, review (when external model needed) |
general | Everyday chat, translation, summarization, writing, Q&A |
cat "$(dirname "$0")/../models.json"
category based on classification rules above"default": true in each category@alias, use that model directlyscripts/call-model.sh --model "MODEL_ID" --prompt "user request" --type chat
With image (vision):
scripts/call-model.sh --model "MODEL_ID" --prompt "request" --type chat --image "IMAGE_URL"
scripts/call-model.sh --model "MODEL_ID" --prompt "image description" --type image
scripts/call-model.sh --model "MODEL_ID" --prompt "task description" --type async
scripts/call-model.sh --model "MODEL_ID" --prompt "text to speak" --type tts --voice alloy
qwen3-vl-235b-a22b-instruct (strongest visual understanding)google/imagen-4-ultra (highest quality)sora-2-pro-all (best results)suno_music / TTS: tts-1-hd or gemini-2.5-pro-preview-ttso3 (strongest reasoning)gpt-5.1-codex-maxclaude-opus-4-6If a model call fails, automatically fall back to the next model in the same category.
Edit models.json to:
The scripts/sync-models.sh script lists all available models from your provider to help discover new ones.
共 1 个版本