Calgine Tokens Docs

简体中文

English

简体中文

English

主题

API 参考概览 ​

Calgine Tokens 全部 API 的调用约定：认证方式、接口分组、错误码与分页规则。

Calgine Tokens 提供 OpenAI 兼容、Anthropic 兼容两类对话接口，以及模型列表、统一异步任务等辅助接口。所有接口共用一套认证与错误约定。

基本信息 ​

项目值
Base URLhttps://api.calgine.com.cn
认证方式请求头 Authorization: Bearer sk-your-token
请求体JSON，Content-Type: application/json

认证 ​

所有接口都需要在请求头中携带 API 令牌：

bash
curl https://api.calgine.com.cn/v1/models \
  -H "Authorization: Bearer sk-your-token"
  • API 令牌在 Calgine Tokens 控制台 的 工作台 → API 令牌 创建
  • Anthropic 兼容接口同时支持 x-api-key 请求头（与官方 SDK 行为一致）
  • 管理类接口（/api/...）使用 Admin Key 而非 API 令牌，见 什么是 Admin Key

WARNING

令牌不要写进前端代码或公开仓库。泄露后请立即在控制台删除并重新创建。

接口分组 ​

对话接口 ​

接口协议说明
POST /v1/chat/completionsOpenAI 兼容对话补全，支持流式与工具调用，见语言模型
POST /v1/responsesOpenAI 兼容Responses 接口，仅支持 OpenAI 模型
POST /anthropic/v1/messagesAnthropic 兼容Messages 接口，适配 Anthropic SDK，见语言模型

模型列表 ​

接口说明
GET /v1/models返回当前令牌可用分组下的全部模型 ID，OpenAI 兼容格式
json
{
  "object": "list",
  "data": [
    { "id": "gpt-4o", "object": "model", "created": 1711234567, "owned_by": "openai" }
  ]
}

异步任务接口 ​

视频、图片、音乐等耗时生成任务统一走异步接口，详见异步任务：

接口说明
POST /v1/task/submit提交任务，立即返回任务 ID
GET /v1/task/{task_id}查询任务状态与结果

错误码 ​

请求失败时返回非 2xx 状态码，响应体为 OpenAI 风格的错误对象：

json
{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}
状态码常见原因
400参数缺失或不合法、模型不可用、请求体格式错误
401令牌无效、已删除或不具备该模型权限
402余额不足，请前往控制台充值
404接口路径错误或任务不存在
429触发限流，请降低请求频率后重试
5xx服务暂时不可用或上游超时，建议稍后重试

异步任务被接受但执行失败时不返回错误码，而是查询任务时 status 为 failed、原因在 error 字段中，见任务状态。

分页 ​

列表类接口（如 Admin Key 的日志、密钥列表）统一使用页码分页：

参数说明
p页码，从 1 开始
page_size每页条数，各接口有各自上限

响应中包含 total（总条数）、page、page_size 等字段；部分接口额外提供 has_more 用于判断是否还有下一页。大时间范围下 total 可能返回 -1 表示未知，此时请以 has_more 为准翻页，详见 Admin Key API 参考。

下一步 ​