Menu
Add a new LLM provider to fusion-api. Use when integrating a new AI model service.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | add-provider |
| description | Add a new LLM provider to fusion-api. Use when integrating a new AI model service. |
| argument-hint | <provider-name> |
Fusion API 通过 LiteLLM 统一接口，添加新提供商只需配置映射，不需要写 adapter。
编辑 app/ai/llm_manager.py：
PROVIDER_LITELLM_PREFIX = {
# ...现有映射...
"{provider}": "{litellm_prefix}", # 新增
}
LiteLLM 前缀说明：
openrouter/{provider}（如 openrouter/openai、openrouter/anthropic）deepseek）openai，通过 api_base 指定实际地址如果新提供商使用 OpenAI 兼容接口但有自己的 base URL，加入：
CUSTOM_BASE_URL_PROVIDERS = {"qwen", "volcengine", "wenxin", "hunyuan", "{provider}"}
凭证的 base_url 字段会被自动读取并传给 LiteLLM。
如果模型支持推理/思考过程输出，加入 StreamHandler：
class StreamHandler:
REASONING_PROVIDERS = {"deepseek", "qwen", "xai", "volcengine", "{provider}"}
在 .env.example 和 docker-compose.yml 中添加：
{PROVIDER_UPPER}_API_KEY=
{PROVIDER_UPPER}_API_BASE= # 如需自定义 base URL
通过 POST /api/models/ 端点或直接在 model_sources 表中插入模型定义：
{
"model_id": "{provider}-model-name",
"name": "模型显示名称",
"provider": "{provider}",
"capabilities": {"deepThinking": true},
"enabled": true
}
然后通过 POST /api/models/{model_id}/credentials 添加凭证。
| 提供商 | 前缀 | 路由方式 | reasoning |
|---|---|---|---|
| openai | openrouter/openai | OpenRouter | - |
| anthropic | openrouter/anthropic | OpenRouter | ✓ |
| openrouter/google | OpenRouter | ✓ | |
| xai | openrouter/x-ai | OpenRouter | ✓ |
| deepseek | deepseek | 直连 | ✓ |
| qwen | openai | OpenAI 兼容（自定义 base） | ✓ |
| volcengine | openai | OpenAI 兼容（自定义 base） | ✓ |
OpenRouter 路由的 provider 只需在凭证中存 OpenRouter API Key，无需 base_url。
# 用 curl 测试新提供商
TOKEN=$(curl -s -X POST http://localhost:8100/auth/login \
-H 'Content-Type: application/json' \
-d '{"email":"Codex-test@fusion.dev","password":"test123456","client_id":"app_xxx"}' \
| python3 -c 'import sys,json;print(json.load(sys.stdin)["access_token"])')
curl -s -N -H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
-X POST http://localhost:8002/api/chat/send \
-d '{"model_id":"{provider}-model","message":"你好","stream":true}'
Add a new FastAPI API endpoint. Use when creating new REST API routes for the application.
Fusion API 项目架构、技术栈、核心组件总览。Use when you need to understand how the backend works, its architecture, or tech stack.
Quick reference for all API endpoints. Use when you need to know available endpoints, their methods, and purposes.
Debug streaming issues (stop not working, content loss, reconnect problems). Use when SSE streaming has bugs.
查看 dev 服务器 fusion-api 日志。Use when debugging backend issues, checking errors, or tracing request flow.
用 curl 测试 dev 服务器 API 端点。Use to verify API behavior, test streaming, or debug issues end-to-end.