拾光集 API 文档

概述

拾光集 API 提供 OpenAI / Anthropic 兼容的模型调用接口，你可以用几乎任何现成的 AI 客户端（ChatGPT SDK、Claude Code、各类套壳工具）接入。本站负责把你的请求安全转发到后端模型服务。

核心能力

OpenAI 兼容

直接使用 /v1/chat/completions 端点，兼容官方 OpenAI SDK 与绝大多数工具。

Anthropic 兼容

支持 /v1/messages 端点，可直接接入 Claude Code 等 Anthropic 协议客户端。

流式输出

完整支持 SSE 流式返回，打字机效果实时呈现。

多模型

可用模型由站长配置，统一通过 /v1/models 列出。

API 兼容性

拾光集 API 兼容 OpenAI 与 Anthropic 两种主流接口风格。如果你已经用过 OpenAI 兼容 API，通常只需修改三处配置：

Base URL

所有 API 请求都应基于以下地址构建：

Base URL：https://coder176.cn/v1

Anthropic 兼容客户端（如 Claude Code）通常填 https://coder176.cn，客户端会自动拼接 /v1/messages。

认证

所有请求都需要携带 API Key。支持以下两种方式（二选一）：

Authorization: Bearer YOUR_API_KEY
x-api-key: YOUR_API_KEY

把 YOUR_API_KEY 替换为站长发放给你的密钥（以 sk- 开头）。

安全提示

你的 API Key 是敏感信息，请妥善保管。
请勿在以下场景暴露：公开代码仓库、前端页面源码、截图/录屏、公开文档、他人可访问的配置文件。
如果你的 Key 不慎泄露，请立即联系站长停用或更换。

快速开始

获取 API Key

联系站长，或在站长提供的入口申请一个以 sk- 开头的密钥。

查看可用模型

调用 GET /v1/models（带你的 Key）即可看到你可用的模型列表。

配置 Base URL

把客户端的 Base URL 设为 https://coder176.cn/v1。

发送请求

填入你的 Key，用 OpenAI 兼容或 Anthropic 兼容格式发起请求即可。

端点列表

方法路径说明
GET/v1/models列出你可用的模型
GET/v1/models/:id单个模型详情
POST/v1/chat/completionsOpenAI 聊天补全（支持流式）
POST/v1/completionsOpenAI 旧版补全
POST/v1/messagesAnthropic Messages（Claude Code 等）
POST/v1/messages/count_tokensAnthropic token 估算
GET/POST/v1/credits · /user/balance查询账户余额（展示用）
GET/health服务健康检查（无需 Key）

代码示例

cURL

curl https://coder176.cn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6",
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}],
    "stream": true
  }'

Python（openai 官方 SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://coder176.cn/v1",
    api_key="YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="gpt-6",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://coder176.cn/v1",
  apiKey: process.env.SHIGUANG_KEY,
});

const resp = await client.chat.completions.create({
  model: "gpt-6",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

接入各类客户端

Claude Code

export ANTHROPIC_BASE_URL="https://coder176.cn"
export ANTHROPIC_API_KEY="YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

其他 OpenAI 兼容工具

在工具的设置里把 Base URL 指向 https://coder176.cn/v1、填入 Key，模型名从 /v1/models 里选即可。

错误码

状态码含义处理建议
401Key 无效 / 缺失检查 Key 是否正确、是否带上了请求头
403Key 被停用或已过期联系站长
404模型不存在（不在你的可用列表）用 /v1/models 查询可用模型
429请求过于频繁 / 超出速率限制（RPM/TPM）降低频率或稍后重试
503上游服务暂不可用稍后重试

常见问题

为什么模型名和我熟悉的名称对不上？

站点对模型名做了统一命名，请以 /v1/models 返回的为准。

支持哪些客户端？

凡是支持「自定义 Base URL + API Key」的 OpenAI 兼容客户端都支持；Anthropic 协议的客户端走 /v1/messages。

余额数字是什么？

用于客户端展示，具体计费方式请咨询站长。

拾光集 API 文档 · 有问题请联系站长