Wentor API 是 Wentor 平台面向学术研究场景提供的接口集合，包含三项服务，均通过 Wentor 平台 API 访问。
基础地址：https://wentor.ai/api/v1/academic 鉴权方式：使用 Wentor 控制台 API Token 区域获取的 Bearer token。
所有端点均要求：有效的 Wentor API token（Authorization: Bearer <token>），以及在控制台中启用对应服务。
一、wentor_qa — 论文问答检索
用途：自然语言论文检索。提出一个问题，返回相关论文。 配额：每日 20 次请求。 速率限制：每分钟 5 次请求。 请求方式：POST /api/v1/academic/qa，Content-Type: application/json，Authorization: Bearer <token>。 请求体示例：{ "query": "attention mechanism transformer", "size": 10, "year": [2024, 2025] } 字段说明：query（string，必填，自然语言问题，2–500 字符）；size（int，可选，默认 10，每页结果数 1–50）；offset（int，可选，默认 0，分页偏移）；sort（string，可选，默认 relevance，可选 relevance、citations 或 year）；year（int[]，可选，默认 null，按发表年份筛选）；sci_only（bool，可选，默认 false，仅返回 SCI 收录论文）。 响应：{ items: [{ id, title, title_zh, doi, ... }], total }。
二、wentor_search — 结构化论文检索
用途：按特定字段检索论文，包括标题、关键词、作者、机构、期刊/会议。 配额：每日 100 次请求。 速率限制：每分钟 10 次请求。 请求方式：GET /api/v1/academic/search，Authorization: Bearer <token>。 参数说明：title（string，至少提供一项，论文标题，部分匹配）；keyword（string，至少提供一项，主题关键词）；author（string，至少提供一项，作者姓名）；org（string，至少提供一项，机构/组织）；venue（string，至少提供一项，期刊或会议名称）；page（int，可选，默认 0，页码，从 0 开始）；size（int，可选，默认 10，每页结果数 1–50）；sort（string，可选，默认 relevance，可选 relevance、citations 或 year）。 title、keyword、author、org、venue 中至少需提供一个。 响应：{ items: [{ id, title, title_zh, doi, ... }], total, page, size }。
三、wentor_plot — 学术配图生成
用途：根据文字描述生成学术配图。仅支持文本生成图像（不支持图像编辑）。 配额：每日 10 次请求。 速率限制：每分钟 2 次请求。 请求方式：POST /api/v1/academic/plot，Content-Type: application/json，Authorization: Bearer <token>。 请求体示例：{ "prompt": "A bar chart comparing BLEU scores of 5 MT models on WMT-2023" } 字段说明：prompt（string，必填，自然语言图形描述，2–2000 字符）。 响应：{ image: "data:image/png;base64,..."|null, text: string|null, prompt: string }。image 为 base64 编码的 PNG data URI；生成失败时为 null。
错误码
401 UNAUTHORIZED：缺少或无效的 API token。 400 MISSING_SEARCH_CRITERIA：未提供任何检索字段（仅 wentor_search）。 400 INVALID_PARAMS：检索参数无效（上游）。 403 SERVICE_NOT_ENABLED：需先在控制台启用该服务。 422 validation error：字段值无效（例如 query 过短）。 429 QUOTA_EXCEEDED：每日配额已用尽，UTC 午夜重置。 429 RATE_LIMITED：每分钟请求过多，请放慢速度。 429 UPSTREAM_RATE_LIMITED：上游服务限流，请稍后重试。 502 UPSTREAM_ERROR：上游服务错误。 503 UPSTREAM_UNAVAILABLE：上游服务暂时不可用。
使用建议
当你有自然语言研究问题并希望发现相关论文时，使用 wentor_qa。 当你已知具体元数据（作者姓名、会议、机构）并希望获得精确结果时，使用 wentor_search。 使用 wentor_plot 生成可用于发表的配图。提示词应尽量具体——包含图表类型、数据描述、坐标轴标签和视觉风格偏好。 可组合使用 wentor_qa + wentor_plot：先检索论文，再将发现可视化为配图。 可在 Wentor 控制台的 Services 区域查看剩余配额。