Developer Docs
API 鉴权
CodeingForce 的 API token 统一使用 sk-... 格式。OpenAI 兼容客户端通常走 Authorization: Bearer,Anthropic 兼容客户端通常走 x-api-key。
请求头格式
Authorization: Bearer <api token>
也可以使用:
x-api-key: <api token>
任选一种即可,不要同时混用两套凭证格式。
最小示例
curl https://codeingforce.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $CODEINGFORCE_API_KEY" \
-d "{\"model\":\"$OPENAI_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"ping\"}]}"
使用建议
- 把 token 放进服务端环境变量,不要直接写进前端 bundle。
- 一个业务系统建议分配独立 token,方便在控制台按 token 维度看用量和扣费。
- 轮换 token 后,旧 token 要同步下线,避免新旧凭证混用。
- 如果你使用 Claude Code 或 Anthropic SDK,
ANTHROPIC_API_KEY里也直接填同一个sk-...token。
常见网关鉴权错误
API token is requiredInvalid API token
如果你拿到的是 401,先检查请求头是否拼写正确,再确认 token 是否已经被禁用、删除或过期,以及 sk-... 格式是否完整。
控制台登录态接口才会返回 Bearer token is required、Invalid bearer token、Bearer token expired 这类 JWT 错误。