{"openapi":"3.0.3","info":{"title":"Chinese Language Intelligence API","description":"AI-powered Chinese language tools, learning intelligence, and developer APIs.","version":"1.0.0","contact":{"email":"api@chinese365.org"}},"servers":[{"url":"https://chinese365.org/v1","description":"Production"}],"security":[{"BearerAuth":[]}],"paths":{"/auth/register":{"post":{"tags":["Auth"],"summary":"Register for free API key","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"}},"required":["email"]}}}},"responses":{"200":{"description":"API key created"},"400":{"description":"Invalid email"}}}},"/character/{char}":{"get":{"tags":["Character"],"summary":"Look up a single Chinese character","parameters":[{"name":"char","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Character data"},"404":{"description":"Not found"}}}},"/pinyin":{"get":{"tags":["Tools"],"summary":"Convert Chinese text to pinyin","parameters":[{"name":"text","in":"query","required":true,"schema":{"type":"string"}},{"name":"style","in":"query","schema":{"type":"string","enum":["marks","numbers","none"]}}],"responses":{"200":{"description":"Pinyin result"}}}},"/hsk/{level}":{"get":{"tags":["HSK"],"summary":"Get words for HSK level","parameters":[{"name":"level","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"HSK word list"}}}},"/sentence/analyze":{"post":{"tags":["AI"],"summary":"Analyze sentence (LLM)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"}}}}}},"responses":{"200":{"description":"Sentence analysis"},"429":{"description":"Rate limited"}}}},"/grammar/check":{"post":{"tags":["AI"],"summary":"Check grammar (LLM)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"learnerLevel":{"type":"string"}}}}}},"responses":{"200":{"description":"Grammar check result"},"429":{"description":"Rate limited"}}}},"/reading/analyze":{"post":{"tags":["AI"],"summary":"Analyze reading level (LLM)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"rewriteTo":{"type":"integer"}}}}}},"responses":{"200":{"description":"Reading analysis"},"429":{"description":"Rate limited"}}}},"/sentence/generate":{"post":{"tags":["AI"],"summary":"Generate example sentences (LLM)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"word":{"type":"string"},"hskLevel":{"type":"integer"},"count":{"type":"integer"}}}}}},"responses":{"200":{"description":"Generated sentences"},"429":{"description":"Rate limited"}}}},"/text/simplify":{"post":{"tags":["AI"],"summary":"Simplify text to HSK level (LLM)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"targetLevel":{"type":"integer"}}}}}},"responses":{"200":{"description":"Simplified text"},"429":{"description":"Rate limited"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key: c365_{tier}_{token}"}}}}