开始使用
用一个 API 密钥调用 LynShen 网关。本页给出 Base URL、认证方式、协议选择和第一个请求。
本指南面向 LynShen 托管服务的用户。你只需要一个 API 密钥，就可以用 OpenAI 或 Anthropic 的协议调用网关中的模型。
准备工作
- 在 www.lynshen.org 注册并登录。
- 验证邮箱。未验证邮箱的账户调用 API 会收到 HTTP
403email_unverified。 - 在控制台的钱包或商店页面充值或购买套餐。余额为零时，请求会收到 HTTP
402insufficient_balance。 - 打开侧边栏中的令牌管理（
/dashboard/tokens），创建一个 API 密钥。密钥以sk-开头。
不要把密钥写进公开仓库、截图或前端代码。密钥泄露后，在令牌管理中禁用或删除它，再创建新的密钥。
Base URL
| 协议 | Base URL | 说明 |
|---|---|---|
| OpenAI 兼容（Chat Completions、Responses、Images、Embeddings） | https://api.lynshen.org/v1 | OpenAI SDK 和大多数工具填写这个地址。 |
| Anthropic 兼容（Messages） | https://api.lynshen.org | Anthropic SDK 会自己拼接 /v1/messages，所以不要带 /v1。 |
网关也接受不带 /v1 的路径，例如 https://api.lynshen.org/chat/completions。网关也接受 /api 前缀，例如 https://api.lynshen.org/api/v1/models。这两种别名与标准路径的行为相同。工具只允许填写主机名时，可以使用这些别名。
https://www.lynshen.org 也能处理 API 请求，但它经过网站的 CDN。程序和工具请统一使用 https://api.lynshen.org。
认证
把密钥放在以下任一请求头中：
Authorization: Bearer sk-...x-api-key: sk-...两个请求头对所有端点都有效。Authorization 必须使用 Bearer 前缀。缺少密钥或密钥无效时，网关返回 HTTP 401 unauthorized。
选择协议
LynShen 在网关内部转换协议。你可以用任意一种协议调用任意一个聊天模型。例如，你可以用 Anthropic Messages 协议调用 GPT 模型，也可以用 Chat Completions 协议调用 Claude 模型。
| 你的情况 | 推荐协议 | 端点 |
|---|---|---|
| 使用 OpenAI SDK、LangChain 或大多数第三方客户端 | Chat Completions | POST /v1/chat/completions |
| 使用 Codex、需要推理摘要或内置图片生成工具 | Responses | POST /v1/responses |
| 使用 Claude Code、Anthropic SDK 或 Messages 格式的工具 | Messages | POST /v1/messages |
| 只需要生成或编辑图片 | Images | POST /v1/images/generations、POST /v1/images/edits |
| 需要文本向量 | Embeddings | POST /v1/embeddings |
完整的端点列表见其他端点。
第一个请求
先把密钥放进环境变量：
export LYNSHEN_API_KEY="sk-..."然后查询你的密钥可以调用的模型：
curl https://api.lynshen.org/v1/models \
-H "Authorization: Bearer $LYNSHEN_API_KEY"从返回的 data[].id 中选一个模型，然后发送一个聊天请求。下面的示例使用 gpt-5.5。如果你的列表中没有这个模型，换成列表中的其他模型。
curl https://api.lynshen.org/v1/chat/completions \
-H "Authorization: Bearer $LYNSHEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{ "role": "user", "content": "用一句话介绍你自己。" }]
}'成功时，Chat Completions 返回 choices[0].message.content，Messages 返回 content[] 中的 text 块。失败时，返回体包含 error 对象。错误码的含义见错误码与限制。
查看用量和费用
- 在控制台的日志页面查看每个请求的模型、Token 数和费用。
- 在模型广场（
/marketplace）查看模型的公开价格。 - 每个响应都带有
x-request-id响应头。联系客服时，请提供这个值。