API Limitations
Understanding API limitations helps better plan your applicationAPI Limits
| Limitation | Value | Description |
|---|---|---|
| Prompt length | 2000 characters | Recommend keeping under 1000 characters for best results |
| Reference image count | Max 5 images | Each image under 10MB |
| Concurrent tasks | 10 tasks | Exceeding will return 429 error |
| Task timeout | 30 minutes | Timeout tasks will be automatically cancelled |
| Video duration | 10-15 seconds | Varies by model |
| Request frequency | 100 requests/min | Exceeding limit will be rate-limited |
Image Format Requirements
- Supported Formats
- Image Specifications
- JPEG (.jpg, .jpeg)
- PNG (.png)
- WebP (.webp)
- File size: Max 10MB per image
- Recommended resolution: 1024x1024 or higher
- Color mode: RGB
- URL requirement: Must be publicly accessible HTTPS link
HTTP Error Codes
4xx Client Errors
5xx Server Errors
API Error Codes
Common Error Code List
| Error Code | Description | Solution |
|---|---|---|
INVALID_PROMPT | Invalid prompt | Check prompt length and content |
INVALID_MODEL | Model does not exist | Use supported model names |
QUOTA_EXCEEDED | Quota exceeded | Contact to increase quota |
TASK_NOT_FOUND | Task does not exist | Check task ID |
INVALID_IMAGE_URL | Invalid image URL | Ensure image is accessible |
IMAGE_TOO_LARGE | Image too large | Compress image to under 10MB |
TASK_TIMEOUT | Task timeout | Resubmit task |
INSUFFICIENT_BALANCE | Insufficient balance | Top up account |
Error Response Format
Troubleshooting Guide
Task Stuck in processing Status
1 Check Task Duration Confirm if exceeds normal processing time (see model documentation) 2 Verify Task ID Ensure using correct task ID for query 3 Check API Status Visit status page or contact support to confirm service status 4 Retry Submission If exceeds 30 minutes, task may have timed out, please resubmitPoor Generation Quality
- Optimize Prompt
- Use Reference Images
- Enable Enhancement
- Choose Appropriate Model
Network Error Handling
Common Questions FAQ
Technical Support
Encountering Issues?
If you encounter issues not covered in the documentation, please contact us via:- Email: threezhang.cn@gmail.com
- WeChat: Kikivivikids
- Telegram: https://t.me/laozhang_cn
- Response time: Within 24 hours on business days
- Task ID
- Error message
- Request parameters (hide sensitive information)
- Problem description