文档
从注册到读取第一条数据，四步完成。
快速上手
注册并创建 API Key
在控制台的 API Keys 页面创建。完整 Key 只显示一次，请立即保存。
免费浏览目录
检索与详情接口不需要 Key，也不扣额度，只限频率。
curl "https://11db.cn/api/v1/search?q=medical" curl "https://11db.cn/api/v1/datasets/<slug>"
读取记录
带上 Key 调用 records 接口，按返回条数扣 token。用 fields 只取需要的字段。
curl -H "Authorization: Bearer 11db_live_…" \ "https://11db.cn/api/v1/datasets/<slug>/records?limit=100&fields=question,answer"
翻页
把返回的 next_cursor 作为下一次请求的 cursor，直到它为 null。
响应头
- X-RateLimit-*
- 当前窗口的限额、剩余次数和重置时间
- Retry-After
- 被限流时，多少秒后可以重试
- X-Tokens-Charged
- 本次扣除的 token
- X-Tokens-Remaining
- 扣费后的剩余额度
- X-Tokens-Truncated
- 是否因余额不足减少了返回条数
- X-Cache
- HIT / MISS / BYPASS
- X-Search-Mode
- hybrid（语义 + 关键词）或 fulltext（仅关键词）
MCP
MCP 端点和 REST 共用额度与限流。单次调用最多返回 200 条，同时受档位单页上限约束。
claude mcp add --transport http 11db https://11db.cn/mcp \ --header "Authorization: Bearer 11db_live_…"
| 工具 | 计费 |
|---|---|
search_datasets | 免费 |
get_dataset | 免费 |
get_usage | 免费 |
query_records | 按条计费 |
search_records | 按条计费 |
错误
{ "error": { "code": "rate_limited", "message": "…", "request_id": "…" } }所有错误都带 code 和 request_id。402 表示额度用完，429 表示超出频率或日额度。