DataEyesAI
Official SiteConsoleDocs Home
Getting StartedDeveloper ToolsAI Models APITerms & Policies
Official SiteConsoleDocs Home
Getting StartedDeveloper ToolsAI Models APITerms & Policies
  1. API Reference​​
  • Documentation
    • Getting Started
      • Welcome to DataEyesAI
      • Quickstart
      • API Keys and Authentication
      • Base URL and SDKs
      • Models, Groups, and Pricing
    • Developer Tool Integration
      • Claude Code
      • Claude Code for VS Code
      • Codex
      • OpenClaw
      • OpenCode
      • Cline
      • Gemini CLI
      • Grok CLI
      • n8n
      • AutoClaw
      • Other tools
      • Claude Code 400 troubleshooting
    • AI Models API
      • API Overview
      • Chat Completions
      • Responses
      • Messages (Claude)
      • Gemini (generateContent)
      • Embeddings
      • Image Models
        • Images
        • Gemini Image Generation
        • Grok Imagine Image
      • Midjourney format
        • Midjourney API Reference
        • Task query interface
        • Upload image
        • Get seed (Seed)
        • Submit Imagine task
        • Query tasks based on ID list
        • FaceSwap
        • Execute Action operation
        • /mj/submit/blend
        • Submit Describe task
        • Submit Modal
        • Refresh link
        • Edit image
        • Query task status by task ID
        • Get the seed of the task image
      • Video Model
        • FLUX Video Generation (flux-3-video)
        • Grok Video Generation
          • 00-Overview
          • 01-Text-to-Video
          • 02-Image-to-Video
          • 03-Reference-to-Video
          • 04-Video-Editing
          • 05-Video-Extension
        • Seedance Video Generation
          • 00-Overview
          • 01-Create-Video-Generation-Task
          • 02-Query-Video-Generation-Task
          • 03-Query-Video-Generation-Task-List
          • 04-Cancel-or-Delete-Task
          • Seedance Private Asset Library API Documentation
        • MiniMax-H3 Video Generation
          • 00-Overview
          • 01-Create-Video-Generation
          • 02-Create-Video-Regeneration
          • 03-Create-H3-Context-IR
          • 04-Query-Task
          • 05-List-Tasks
          • 06-Cancel-or-Delete-Task
        • Hailuo Video Generation
          • 00-Overview
          • 01-Text-to-Video-T2V
          • 02-Image-to-Video-I2V
          • 03-First-Last-Frame-FL2V
          • 04-Subject-Reference-S2V
          • 05-Query-Task-Status
          • 06-Video-Download
          • 99-Appendix-Camera-Movement-and-Webhooks
        • Jimeng Video Generation
          • 00-Overview
          • 01-3.0-Pro-Video-Generation
          • 02-720P-Text-to-Video
          • 03-720P-Image-to-Video-First-Frame
          • 04-720P-Image-to-Video-Start-End-Frame
          • 05-720P-Image-to-Video-Camera
          • 06-1080P-Text-to-Video
          • 07-1080P-Image-to-Video-First-Frame
          • 08-1080P-Image-to-Video-Start-End-Frame
          • 09-Error-Codes
        • Kling AI Video Generation
          • 00-Overview
          • 01-Text-to-Video
          • 02-Image-to-Video
          • 03-Omni-Video
          • 04-Multi-Image-to-Video
          • 05-Motion-Control
          • 06-Multi-Elements
          • 07-Video-Extension
          • 08-Lip-Sync
          • 09-Avatar
          • 10-Text-to-Audio
          • 11-Video-to-Audio
          • 12-TTS
          • 13-Custom-Voices
          • 14-Image-Recognition
          • 15-Element-Management
          • 16-Video-Effects
          • 17-Kling-4.0-Video-Generation
        • Vidu Video Generation
          • 00-Overview
          • 01-Text-to-Video
          • 02-Image-to-Video
          • 03-Reference-to-Video
          • 04-Start-End-Frame
          • 05-Multi-Frame
          • 06-Scene-Template
          • 07-Template-Story
          • 08-Query-Tasks
        • HappyHorse
          • HappyHorse Text-to-Video
          • HappyHorse Image-to-Video (First Frame)
          • HappyHorse Reference-to-Video
          • HappyHorse Video Editing
        • Wan Video Generation
          • 00-Overview.md
          • 01-Text-to-Video
          • 02-Image-to-Video
          • 03-Reference-to-Video
          • 04-Video-Editing
          • 05-First-Last-Frame-to-Video
          • 06-Motion-Transfer-and-Character-Swap
          • 07-Digital-Human-Video
          • 08-VACE-Video-Editing
          • 09-Query-Task
      • Audio API
        • Audio API
        • Gemini TTS API
        • Google DeepMind Lyria API
        • Elevenlabs Speech to Text API Reference
    • Search / Reader Product
      • Search & Reader
      • Web Search
      • Search and Read
      • Video Search
      • Web Reader
      • Document Parsing
      • Trending
      • Weather
      • All City ID
    • Advanced & System API
      • FAQ
      • System interface
        • API Key & Quota Query API
        • API Key Management API
      • API Reference​​
        • Error Codes
        • Rate Limits and Billing Rules
      • List models
        • Models
  • Terms & Policies
    • DataEyesAI API Terms of Service
    • DataEyesAI Legal Notice and Privacy Policy
    • DataEyesAI Paid Services Agreement
    • Automatic Renewal Service Rules
  1. API Reference​​

Error Codes

When a request fails, the API returns a non-200 HTTP status code and an error message. Record the request id in the response; you can use it to look up the request in Call Diagnostics in the console or share it with support.

AI Model API#

Error responses follow the OpenAI format (APIs using the Anthropic or Gemini protocol return their own standard error formats):
{
  "error": {
    "code": "",
    "message": "无效的令牌 (request id: 20261024045136443822397f1ThV5v7)",
    "type": "server_error"
  }
}
HTTP statusTypical messageCause and fix
400Parameter error, invalid_request_errorThe request body or parameters do not meet the model's requirements. Check the JSON format, parameter names, and value ranges
401无效的令牌 (invalid token)The key is wrong, deleted, or from another site. Confirm the key in the console
401 / 403该令牌已过期 (token expired), 该令牌额度已用尽 (token quota exhausted), 该令牌状态不可用 (token unavailable)The key has expired, hit its quota limit, or been disabled. Adjust it in Model API key
403用户额度不足 (insufficient account balance)Your account balance is too low. Top up
403error code: 1010Blocked by the security layer because the request has no User-Agent. Use an official SDK or set a User-Agent
404Invalid URL, 404 page not foundWrong path, usually one /v1 too many or too few in the base URL. See Base URL and SDKs
404 / 503模型不存在或已下架 (model not found or retired), 分组 xxx 下模型 xxx 无可用渠道 (no available channel for model xxx in group xxx)The model name is misspelled, or your key's group does not support this model. Switch to Stability First or use a group that supports the model
429当前分组上游负载已饱和,请稍后再试 (group is at capacity, try again later)Too many requests or resources are busy. Reduce concurrency and retry with exponential backoff
500 / 502upstream error, do request failedUpstream service error. Retry later; if it persists, contact support with the request id
504 / 524Gateway timeoutGeneration took too long. Enable streaming ("stream": true) or increase your client timeout
Retry guidance
Retry 429, 500, 502, 503, and 504 automatically with exponential backoff (for example 1s, 2s, 4s, up to 3–5 attempts). 400, 401, 403, and 404 are caused by the request itself, so retrying will not help.

Search & Reader API#

On success, code is 0. On failure, the response uses one of these shapes:
{ "code": 40001, "data": null, "message": "parameters err" }
{ "error": "Invalid api key" }
HTTP statuscode / errorDescription and fix
40040001 parameters errA parameter is missing or malformed, for example no q or url
40040003 Invalid protocolInvalid URL scheme; only http / https are supported
400 / 50032003 Unsupported content typeThe file or page content type cannot be parsed
401Invalid api keyThe key is wrong, or a Model API key was used by mistake
403search quota exceeded / reader quota exceededSearch or reader credits are used up. Buy a plan
429Rate limit exceededRate limit exceeded. See Rate limits and billing rules
50032000 Failed to extract contentThe page content could not be extracted. Try another URL or adjust waitUntil
50032001 Target URL is unreachableThe target URL cannot be reached
50032002 Request timeoutReading timed out. Increase timeout and retry
50032004 SSL certificate errorThe target site has an SSL certificate problem
50050001 internal server errorInternal server error. Retry later; if it persists, contact support
Failed requests do not consume credits.

Get help#

When contacting support, include your account email, the request time, the request id, and the full error message.
Previous
API Key Management API
Next
Rate Limits and Billing Rules