Developer Docs

API 鉴权

CodeingForce 文档中心

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 required
  • Invalid API token

如果你拿到的是 401,先检查请求头是否拼写正确,再确认 token 是否已经被禁用、删除或过期,以及 sk-... 格式是否完整。

控制台登录态接口才会返回 Bearer token is requiredInvalid bearer tokenBearer token expired 这类 JWT 错误。

文档中心联系客服