接口文档

VeriSource API 提供 12 个 RESTful 端点 + 2 个实时通道，覆盖信息搜索、验证、提交、图谱、向量的完整生命周期。

快速开始

1. 获取 API Key

在 API Keys 页面创建密钥

2. 发送请求

Header 中添加 Authorization: Bearer KEY

3. 解析响应

所有响应均为 JSON 格式

Base URLhttps://api.verisource.cn/v1

SDK 安装

Python

pip install verisource

JavaScript / Node.js

npm install verisource

go get verisource.cn/sdk

认证方式

所有请求需在 HTTP Header 中传入 API Key 进行 Bearer Token 认证。

Authorization: Bearer vs_live_xxxxxxxxxxxxxxxxxxxx

错误码说明

状态码	说明
200	请求成功
201	资源创建成功
400	请求参数错误 — 检查参数格式和必填项
401	认证失败 — API Key 无效或已过期
403	权限不足 — 当前套餐无权访问此端点
404	资源不存在 — 信息 ID 无效
409	冲突 — 重复提交
422	参数校验失败 — 参数值不合法
429	请求过频 — 已达速率限制，请稍后重试
500	服务内部错误 — 请联系技术支持
503	服务暂时不可用 — 维护中

API 端点

点击端点展开查看参数表、请求示例和响应示例。

GET/info/search语义搜索信息▸

参数

参数	类型	必填	说明
q	string	必填	搜索关键词或自然语言查询
domain	string	可选	领域过滤：science, tech, economy, medical, history 等
status	string	可选	验证状态过滤：verified, disputed, falsified, pending
min_credibility	number	可选	最低可信度阈值 (0-100)，默认 0
sort	string	可选	排序方式：relevance(默认), credibility, date, citations
limit	integer	可选	返回条数，默认 20，最大 100
offset	integer	可选	分页偏移量，默认 0

请求示例

curl -X GET "https://api.verisource.cn/v1/info/search?q=量子计算&status=verified&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "total": 1283,
  "offset": 0,
  "limit": 5,
  "results": [
    {
      "id": "info_8f3a2b",
      "title": "九章三号光量子计算突破",
      "summary": "255个光子的玻色取样实验...",
      "status": "verified",
      "credibility": 96.4,
      "domain": "science",
      "created_at": "2025-11-02T08:30:00Z",
      "citations": 847,
      "evidence_count": 12
    },
    ...
  ]
}

GET/info/{id}获取单条信息详情▸

POST/info/submit提交新信息▸

POST/info/verify验证信息真伪▸

POST/info/batch批量操作▸

GET/embedding/{id}获取语义向量▸

POST/similar向量近邻搜索▸

GET/graph/{id}关系图谱查询▸

GET/ranking信息排行榜▸

GET/predictions预测追踪▸

SSE/stream实时信息流 (Server-Sent Events)▸

WS/wsWebSocket 全双工通道▸

速率限制

超过限额将返回 429 Too Many Requests，响应 Header 包含 Retry-After 字段。

套餐	月请求量	速率上限	并发数	价格
Explorer	1,000	10/分钟	2	免费
Builder	100,000	100/分钟	10	¥99/月
Pro	1,000,000	1,000/分钟	50	¥499/月
Enterprise	无上限	自定义	自定义	联系销售

用户协议隐私政策

ICP备案号：京ICP备2024061589号-8

京公网安备11010602202380号

加载中…