Anthropic

Anthropic 兼容接口

和 Anthropic 官方 API 一模一样。把 Anthropic SDK 的 base_url 指向下面的地址,其余不动。

基础地址

加载中…

接入

加载中…

端点

方法路径说明支持
POST/v1/messages发送消息● 支持
POST/v1/messages/count_tokens统计 token◐ 部分支持
GET/v1/models列出模型● 支持
POST/v1/files上传文件● 支持
GET/v1/files列出文件● 支持
GET/v1/files/{file_id}读取文件信息● 支持
DELETE/v1/files/{file_id}删除文件● 支持
GET/v1/files/{file_id}/content下载文件内容● 支持

与官方的差异

  • 发送消息:支持顶层 cache_control、top_k、metadata.user_id、output_config.format、thinking.display 与 anthropic-user-profile-id。仅原生 Anthropic 能表达的选项会限制路由;没有可保真供应时返回参数错误。anthropic-workspace-id 尚未支持,非空值返回 400。container、inference_geo 与 service_tier 接受并忽略;其他扩展见字段支持标注。 未知顶层字段原样转发给同协议上游,由上游决定是否接受;已声明字段的类型与取值范围仍会校验,不合法时返回 400 并点名字段。
  • 统计 token:按模型族校准的估算值(包括中文和工具定义),响应头为 x-praxis-token-count: estimated;不能用作精确用量或计费依据。
  • 列出模型:始终返回 capabilities、max_input_tokens、max_tokens;目录无法确定的值为 null,不将总上下文窗口冒充独立输入上限。非空 anthropic-workspace-id 返回 400;尚不按 anthropic-beta 选择目录版本。
  • 上传文件:SDK 0.128.0 上传参数为表单 file 和可选的表单 expires_in_seconds(3600–7776000 秒)。其他表单字段(包括 purpose)返回 400 invalid_request_error,消息形如 "purpose: Extra inputs are not permitted";查询参数只接受 SDK 自带的 beta,其他查询参数返回 400,查询参数 expires_in_seconds 会提示改放表单。平台将上传文件记为 user_data;不支持 anthropic-workspace-id,请求携带该头时返回 400。
  • 列出文件:按创建时间从新到旧排列。用 after_id / before_id 与 limit 分页(两者同时给返回 400),也可以用 page 游标(next_page);三者只能选一个。响应包含 data、has_more、first_id、last_id 与 next_page。ids(最多 100 个去重 ID)与 page、after_id、before_id、limit 互斥。scope_id 需要 anthropic-beta: managed-agents-2026-04-01 请求头;缺少该头返回 400,不存在的会话范围返回 404。anthropic-workspace-id 返回 400。
  • 下载文件内容:只有代码执行工具生成的文件可以下载;你自己上传的文件(用途为 user_data)下载会返回 400 invalid_request_error,这与 Anthropic 官方的行为一致。

参数与字段的权威定义以 Anthropic 官方文档为准。

错误按 Anthropic 格式返回,参见错误;额度与响应头参见限流。

导出

本页内容