{
 "schema_version": "1.0",
 "dataset": "deepseek-api-endpoints",
 "verified_at": "2026-11-04",
 "base_url": "https://api.deepseek.com",
 "auth": "Bearer token in Authorization header",
 "endpoints": [
  {
   "method": "POST",
   "path": "/chat/completions",
   "description": "OpenAI-compatible chat completion; the main entry point"
  },
  {
   "method": "POST",
   "path": "/completions",
   "description": "Legacy text completion"
  },
  {
   "method": "GET",
   "path": "/models",
   "description": "List available model ids"
  },
  {
   "method": "GET",
   "path": "/user/balance",
   "description": "Account balance"
  }
 ],
 "error_codes": [
  {
   "code": 400,
   "meaning": "Invalid request body format",
   "retry": false
  },
  {
   "code": 401,
   "meaning": "Authentication failed",
   "retry": false
  },
  {
   "code": 402,
   "meaning": "Insufficient balance",
   "retry": false
  },
  {
   "code": 422,
   "meaning": "Invalid parameters",
   "retry": false
  },
  {
   "code": 429,
   "meaning": "Rate limit / concurrency exceeded",
   "retry": true
  },
  {
   "code": 500,
   "meaning": "Server error",
   "retry": true
  },
  {
   "code": 503,
   "meaning": "Server overloaded",
   "retry": true
  }
 ]
}