用途：帮助初学者完成 OpenRouter 的首次 API 调用，验证密钥与网络连通性，并理解响应结构。所有请求都发往单一端点 POST https://openrouter.ai/api/v1/chat/completions。
主要能力：发送最小聊天补全请求；解析响应中的 id、model、usage、finish_reason 四个关键字段；用同一套代码切换不同模型（含 :free 免费模型与 openrouter/auto 自动路由）；通过 GET /api/v1/generation?id=gen-... 查询该次请求的 token 与成本。
使用方式：需准备 OpenRouter API 密钥（sk-or-v1-...）并导出为 OPENROUTER_API_KEY；命令行需 curl 与 jq，或使用 Python 3.8+ / Node.js 18+ 配合 OpenAI SDK（pip install openai / npm install openai）。最小请求示例：curl -s https://openrouter.ai/api/v1/chat/completions -H "Authorization: Bearer $OPENROUTER_API_KEY" -H "Content-Type: application/json" -d '{"model":"google/gemma-2-9b-it:free","messages":[{"role":"user","content":"Say hello in three languages"}],"max_tokens":100}' | jq .。SDK 方式将 base_url 设为 https://openrouter.ai/api/v1，并可设置 HTTP-Referer 与 X-Title 头用于用量归属。
适用场景：学习 OpenRouter、测试环境配置、验证连通性、对比多模型输出、审计单次请求成本。
限制与注意：免费模型无需额度，付费模型需余额，否则返回 402；密钥无效或缺失返回 401；base URL 或模型 ID 错误返回 404；JSON 格式错误或缺少 messages 返回 400。建议始终设置 max_tokens 防止无界补全，先用免费模型测试再切换付费模型。资料未提供具体价格、速率限制或平台支持范围。