Space Bunny Alpha API：从一次请求开始

准备账户与密钥

在 OpenRouter 创建账户并生成自己的密钥，在服务端环境变量中保存 OPENROUTER_API_KEY。不要把密钥写入公开仓库、浏览器代码或 URL。使用模型前阅读其页面与 Stealth 条款，尤其是向其他用户提供服务时。

最小文本请求

向以下地址发送 POST，设置 Content-Type: application/json 和 Authorization: Bearer 后接你的服务端 Key。请求体示例如下。

https://openrouter.ai/api/v1/chat/completions

{
  "model": "stealth/space-bunny-alpha",
  "messages": [
    {
      "role": "user",
      "content": "Explain a hash table with an example."
    }
  ],
  "reasoning": {
    "effort": "low"
  },
  "max_tokens": 2048
}

按需求增加能力

• 用 reasoning.effort 调整推理；更高强度可能增加延迟与输出预算消耗。
• 启用 stream 接收 SSE，正确处理分块、错误与完成标记。
• 以 image_url / video_url 消息部分添加媒体，注意提供方的格式与 URL 支持。
• JSON 输出可使用 response_format；工具调用则需由应用执行工具并回传结果。

在终端试一次

以下命令适用于 Bash、macOS 或 Linux。先在当前终端设置 OPENROUTER_API_KEY 环境变量；不要把真实密钥保存到此示例中。

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"stealth/space-bunny-alpha","messages":[{"role":"user","content":"Reply with exactly HELLO."}],"max_tokens":256}'

非流式结果的文字位于 choices[0].message.content。先检查 HTTP 状态及响应中的 error，再读取 choices；工具调用时 message 可能包含 tool_calls 而不是最终文字。

请求失败时先检查什么？

• 401：检查服务端环境变量是否存在，密钥是否属于当前 OpenRouter 账户；不要在日志中打印密钥。
• 402：检查账户余额、付款资料和模型是否对账单地区开放；不要把这个错误当成 JSON 或提示词问题。
• 429 或超时：查看限流信息并有限次数退避重试；流式响应已经开始时也要处理错误事件。

错误码的具体解释以 OpenRouter 返回体及其文档为准；本站不会替开发者提供 API 额度。

不要把免费预览当作可用性保证

模型当前列出免费价格，但密钥仍有账户限制，上游可能限流或下线。处理 429、超时、空回答与中断响应，不无限重试。提供方可能保留输入输出，避免敏感材料。公开提供 SaaS 前确认条款适用。

继续阅读