Access Wentor platform academic services — paper Q&A search, structured paper search, and AI figure generation. Requires a Wentor API token.
Three services for academic research, accessible via the Wentor platform API.
Base URL: https://wentor.ai/api/v1/academic
Auth: Bearer token from your Wentor dashboard → API Token section.
All endpoints require:
Authorization: Bearer <token>)Natural-language paper search. Ask a question, get relevant papers.
POST /api/v1/academic/qa
Content-Type: application/json
Authorization: Bearer <token>
{ "query": "attention mechanism transformer", "size": 10, "year": [2024, 2025] }
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | yes | — | Natural language question (2–500 chars) |
size | int | no | 10 | Results per page (1–50) |
offset | int | no | 0 | Pagination offset |
sort | string | no | relevance | relevance, citations, or year |
year | int[] | no | null | Filter by publication year(s) |
sci_only | bool | no | false | Only return SCI-indexed papers |
Response: { items: [{ id, title, title_zh, doi, ... }], total }.
Search papers by specific fields: title, keyword, author, organization, venue.
GET /api/v1/academic/search
Authorization: Bearer <token>
| Param | Type | Required | Default | Description |
|---|---|---|---|---|
title | string | at least one | — | Paper title (partial match) |
keyword | string | at least one | — | Topic keyword |
author | string | at least one | — | Author name |
org | string | at least one | — | Institution/organization |
venue | string | at least one | — | Journal or conference name |
page | int | no | 0 | Page number (0-indexed) |
size | int | no | 10 | Results per page (1–50) |
sort | string | no | relevance | relevance, citations, or year |
At least one of title, keyword, author, org, or venue is required.
Response: { items: [{ id, title, title_zh, doi, ... }], total, page, size }.
Generate academic figures from text descriptions. Text-to-image only (no image editing).
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" }
| Field | Type | Required | Description |
|---|---|---|---|
prompt | string | yes | Figure description in natural language (2–2000 chars) |
Response: { image: "data:image/png;base64,..."|null, text: string|null, prompt: string }.
image is a base64-encoded PNG data URI. null if generation failed.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | UNAUTHORIZED | Missing or invalid API token |
| 400 | MISSING_SEARCH_CRITERIA | No search field provided (wentor_search only) |
| 400 | INVALID_PARAMS | Invalid search parameters (upstream) |
| 403 | SERVICE_NOT_ENABLED | Enable the service in your dashboard first |
| 422 | validation error | Invalid field value (e.g., query too short) |
| 429 | QUOTA_EXCEEDED | Daily quota exhausted, resets at midnight UTC |
| 429 | RATE_LIMITED | Too many requests per minute, slow down |
| 429 | UPSTREAM_RATE_LIMITED | Upstream service rate limited, retry later |
| 502 | UPSTREAM_ERROR | Upstream service error |
| 503 | UPSTREAM_UNAVAILABLE | Upstream service temporarily unavailable |