即刻数算 API 文档

快速开始

1. 申请 Key：在官网「联系我们」表单选择「API 申请」，注明公司名与预计用量。审核后我们会签发 akj_live_（正式）或 akj_sandbox_（联调）Key。明文只显示一次，请妥善保存。

2. 发起请求：所有请求带认证头 Authorization: Bearer <你的Key>，Content-Type 为 application/json（上传文件为 multipart/form-data）。

# 上传表格
curl -X POST https://app.instaecho.com/v1/customer/files \
  -H "Authorization: Bearer <你的Key>" \
  -F "file=@10月发票.xlsx"

# 自然语言问答
curl -X POST https://app.instaecho.com/v1/customer/ask \
  -H "Authorization: Bearer <你的Key>" \
  -H "Content-Type: application/json" \
  -d '{"question": "价税合计总额是多少？", "datasource_ids": ["<上传返回的datasource_id>"]}'

3. Python SDK（可选）：仓库 sdk/python/jike_accounting.py 单文件封装，依赖仅 httpx：

from jike_accounting import JikeAccounting

with JikeAccounting("akj_live_...") as c:
    ds = c.upload("10月发票.xlsx")
    print(c.ask("价税合计总额是多少？", datasource_ids=[ds["datasource_id"]])["answer"])

规则与限制

项目	默认	说明
问答配额	1000 次/月	按客户合同约定，次月 1 日重置
存储配额	100 MB	超限拒绝新上传（QUOTA_EXCEEDED），已有数据不受影响
速率限制	60 次/分钟	按 Key 滑动窗口，超限返回 RATE_LIMITED
文件格式	.xlsx / .csv	单文件 ≤20MB
数据保留	不自动删除	客户数据由配额与合同管理，可随时自助删除

错误格式

所有错误统一为 { code, message, trace_id }。排障时请提供 trace_id。常见 code：

HTTP	code	含义
401	INVALID_API_KEY / KEY_REVOKED / KEY_EXPIRED	Key 无效、已停用或已过期
403	CUSTOMER_SUSPENDED	客户账户停用
429	QUOTA_EXCEEDED / RATE_LIMITED	配额用尽 / 请求过快
400	INVALID_REQUEST	参数不合法（message 含具体原因）
404	DATASOURCE_NOT_FOUND 等	资源不存在或无权访问

完整错误码与各端点字段见下方契约文档。控制台（用量查询、Key 轮换）：app.instaecho.com/console.html