Skills 快速上手
先把一个内置 skill 跑通，再决定是否继续把执行、管理和计费统一收进服务端。
Skills 的最小使用方式很简单：在普通请求上再加一个 skills 数组。 TheRouter 负责把 skill 的工具注入进去，并在模型调用时由服务端执行，再把最终结果返回给你。
发送一个最小请求
curl
curl https://api.therouter.ai/v1/chat/completions \
-H "Authorization: Bearer $THEROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-sonnet-4.5",
"messages": [{ "role": "user", "content": "最近量子计算有哪些突破？" }],
"skills": [{ "id": "web" }]
}'返回格式
返回值仍然是标准 chat completion。像联网 skill 这类会带来引用时， 结果会在 assistant message 上补充 url_citation 注解。
response.json
{
"choices": [{
"message": {
"role": "assistant",
"content": "最近的量子计算突破包括 ...",
"annotations": [
{
"type": "url_citation",
"url_citation": {
"url": "https://example.com/quantum-2026",
"title": "Quantum Computing Advances in 2026"
}
}
]
}
}]
}SDK 版最小示例
TypeScript
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.therouter.ai/v1",
apiKey: process.env.THEROUTER_API_KEY,
});
const completion = await client.chat.completions.create({
model: "anthropic/claude-sonnet-4.5",
messages: [{ role: "user", content: "最近量子计算有哪些突破？" }],
skills: [{ id: "web" }],
} as never);
console.log(completion.choices[0]?.message?.content);别在太早的时候加复杂度
如果你还没跑通最基础的第一个请求，不要一上来就加多个 skills、复杂 schema 和外部成本。 先跑通一个，再逐步扩展。