跳转到主要内容

API 文档

快速开始

在控制台创建 API 密钥,再把它作为 Bearer 令牌调用接口。

请求方式
POST
内容类型
以各产品文档为准(文件上传或 JSON)

鉴权

密钥只在创建时显示一次。

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
创建 API 密钥

错误格式

失败时 success 为 false,error 给出原因。响应头 X-Request-ID 用于查询网关日志;后端响应中的 request_id 用于追踪处理结果,两者独立。

HTTP code 说明
401 UNAUTHENTICATED API 密钥缺失或无效。
402 SUBSCRIPTION_REQUIRED 当前没有可用积分包。
402 QUOTA_EXHAUSTED 当前可用积分已用完。
429 RATE_LIMITED 请求超过限流频率。

积分与限流

  • 只有成功的调用才扣积分;失败、被限流或服务异常不扣。
  • 账户下所有 API 密钥共享同一份积分;积分通用于所有产品。
  • OCR 每分钟最多 60 次,PDF 转图片每分钟最多 10 次,超出返回 429。各产品分开计数。