Chinese365

Chinese Language Intelligence API

Programmatic access to the same AI-powered Chinese tools that power Chinese365.org. Built for developers, schools, and content platforms.

Base URL

https://api.chinese365.org/v1

Authentication

All requests require a Bearer token:

Authorization: Bearer c365_live_xxxxxxxxxxxxxxxxxxxxx

Endpoints

GET/v1/character/{char}free

Look up a single Chinese character.

GET /v1/character/学
GET/v1/pinyin?text=...free

Convert Chinese text to pinyin. Local, no LLM cost.

GET /v1/pinyin?text=我喜欢学习中文&style=marks
GET/v1/hsk/{level}free

Get all words for an HSK level (1-9).

GET /v1/hsk/1
POST/v1/sentence/analyzestarter

Analyze sentence: tokens, grammar, HSK level, difficulty, translation. (LLM)

POST { text: "我昨天去了北京。" }
POST/v1/grammar/checkstarter

Find grammar errors with explanations. (LLM)

POST { text: "我很喜欢吃了中国菜。", learnerLevel: "HSK 2" }
POST/v1/reading/analyzegrowth

Estimate reading level + optional rewrite to target HSK. (LLM)

POST { text: "...", rewriteTo: 3 }
POST/v1/sentence/generategrowth

Generate example sentences at a target HSK level. (LLM)

POST { word: "学", hskLevel: 2, count: 5 }
POST/v1/text/simplifygrowth

Rewrite text at a specific HSK level. (LLM)

POST { text: "...", targetLevel: 3 }

Rate limits

PlanMonthlyRatePrice
Free1,00010/min$0
Starter50,000100/min$9
Growth250,000500/min$29
Pro1,000,0002,000/min$99
Business5,000,00010,000/min$299

Common error codes

400 INVALID_REQUEST — Bad parameters
401 UNAUTHORIZED — Missing API key
403 FORBIDDEN — Key lacks access
404 NOT_FOUND — Resource not found
429 RATE_LIMITED — Rate limit hit
503 LLM_UNAVAILABLE — All AI providers down
Phase 2 status: Endpoints are scaffolded and will return cached or fallback responses without an API key. LLM providers are auto-fallback chained: DeepSeek-V3 → Qwen-Plus → GPT-4o-mini. All responses are Redis-cached permanently by input hash.
Want an API key? Contact api@chinese365.org (Phase 3 will formalize signup).
← Back to all tools