快速开始
在控制台创建 API 密钥,再把它作为 Bearer 令牌调用接口。
- 请求方式
POST- 内容类型
- 以各产品文档为准(文件上传或 JSON)
鉴权
密钥只在创建时显示一次。
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
错误格式
失败时 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。各产品分开计数。