gabrielmoreira Wentor Academic API
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:
- A valid Wentor API token (
Authorization: Bearer <token>) - The corresponding service enabled in your dashboard
1. wentor_qa — Paper Q&A Search
Natural-language paper search. Ask a question, get relevant papers.
- Quota: 20 requests/day
- Rate limit: 5 requests/minute
Request
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 }.
2. wentor_search — Structured Paper Search
Search papers by specific fields: title, keyword, author, organization, venue.
- Quota: 100 requests/day
- Rate limit: 10 requests/minute
Request
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 }.
3. wentor_plot — Academic Figure Generation
Generate academic figures from text descriptions. Text-to-image only (no image editing).
- Quota: 10 requests/day
- Rate limit: 2 requests/minute
Request
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.
Error Codes
| 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 |
Usage Tips
- Use wentor_qa when you have a natural-language research question and want to discover relevant papers.
- Use wentor_search when you know specific metadata (author name, conference, institution) and want precise results.
- Use wentor_plot to generate publication-ready figures. Be specific in your prompts — include chart type, data description, axis labels, and visual style preferences.
- Combine wentor_qa + wentor_plot: search for papers first, then visualize findings as figures.
- Check your remaining quota on the Wentor dashboard under the Services section.