快速开始
五分钟完成令牌获取与第一个 API 请求——base_url、鉴权头、三语言可跑通示例与成功验证。
第一步：获取令牌
- 在 积木官网 注册并登录
- 进入控制台「令牌」页面，创建新令牌
- 复制以
sk-开头的令牌
令牌等同于账号凭证，不要提交到代码仓库或写进前端代码，用环境变量注入。
下文示例统一从环境变量
JIMU_API_KEY 读取。第二步：记住两个接入参数
| 参数 | 值 |
|---|---|
base_url | https://api.jimu.chat/v1 |
api_key | 你的令牌（sk-***） |
已经在用 OpenAI SDK 的代码，只需替换这两个值即可接入。
第三步：发出第一个请求
curl https://api.jimu.chat/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $JIMU_API_KEY" \
-d '{
"model": "gpt-5.6-luna",
"messages": [{ "role": "user", "content": "你好，用一句话介绍你自己" }]
}'
第四步：验证成功
请求成功时你会收到标准的 OpenAI 响应结构，choices[0].message.content 是模型回复：
{
"id": "chatcmpl-...",
"object": "chat.completion",
"choices": [
{ "index": 0, "message": { "role": "assistant", "content": "……" }, "finish_reason": "stop" }
],
"usage": { "prompt_tokens": 13, "completion_tokens": 32, "total_tokens": 45 }
}
模型与端点有协议归属。 同一个模型名在不同端点上的可用性不同：例如
claude-sonnet-5
不能用于本页的 /v1/chat/completions（会报 format_not_accepted），必须走 Anthropic 原生端点
/v1/messages，详见 Anthropic Messages。
示例模型以 模型列表 实时返回为准。常见首次接入失败：
| 现象 | 原因与处理 |
|---|---|
| HTTP 401 | 令牌错误或被撤销，重新复制完整 sk- 令牌 |
| HTTP 403 无权限访问 | 令牌无权访问该模型，先用 模型列表 查可用模型 |
HTTP 400 format_not_accepted | 模型与端点协议不匹配（如 claude 模型走了 chat/completions），改用对应原生端点或换模型 |
model_not_found | 模型名拼写错误或无可用渠道，以接口返回的模型 ID 为准 |
| 其他错误形态 | 见 错误处理与请求追踪 |