​
限制说明

了解 API 限制有助于更好地规划您的应用

​
API 限制

限制项限制值说明
提示词长度2000 字符建议控制在 1000 字符以内获得最佳效果
参考图片数量最多 5 张每张图片不超过 10MB
并发任务数10 个超出将返回 429 错误
任务超时时间30 分钟超时任务将自动取消
视频时长10-15 秒根据模型不同有所差异
请求频率100 次/分钟超出限制将被限流

​
图片格式要求

  • JPEG (.jpg, .jpeg)
  • PNG (.png)
  • WebP (.webp)

​
HTTP 错误码

​
4xx 客户端错误

​
5xx 服务器错误

​
API 错误码

​
常见错误码列表

错误码说明解决方案
INVALID_PROMPT提示词无效检查提示词长度和内容
INVALID_MODEL模型不存在使用支持的模型名称
QUOTA_EXCEEDED配额超限联系增加配额
TASK_NOT_FOUND任务不存在检查任务 ID
INVALID_IMAGE_URL图片 URL 无效确保图片可访问
IMAGE_TOO_LARGE图片过大压缩图片至 10MB 以下
TASK_TIMEOUT任务超时重新提交任务
INSUFFICIENT_BALANCE余额不足充值账户

​
错误响应格式

{
  "success": false,
  "message": "错误描述信息",
  "error_code": "ERROR_CODE",
  "details": {
    "field": "具体错误字段",
    "reason": "错误原因",
    "suggestion": "解决建议"
  }
}

​
故障排查指南

​
任务一直处于 processing 状态

1

检查任务时长

确认是否超过正常处理时间（见模型说明）
2

验证任务 ID

确保使用正确的任务 ID 进行查询
3

检查 API 状态

访问状态页面或联系支持确认服务状态
4

重试提交

如果超过 30 分钟，任务可能已超时，请重新提交

​
生成质量不理想

# 优化前
prompt = "猫"

# 优化后
prompt = """
一只橘色的英短猫在阳光明媚的客厅里，
慵懒地躺在柔软的沙发上，
午后的阳光透过窗户洒在它身上，
4K画质，温暖色调
"""

​
网络错误处理

import requests
from requests.adapters import HTTPAdapter
from requests.packages.urllib3.util.retry import Retry

def create_session():
    session = requests.Session()
    retry = Retry(
        total=3,
        read=3,
        connect=3,
        backoff_factor=0.3,
        status_forcelist=(500, 502, 504)
    )
    adapter = HTTPAdapter(max_retries=retry)
    session.mount('http://', adapter)
    session.mount('https://', adapter)
    return session

# 使用带重试的会话
session = create_session()
response = session.post(url, json=data, headers=headers)

​
常见问题 FAQ

​
技术支持

遇到问题？

如果您遇到文档中未涵盖的问题，请通过以下方式联系我们：联系时请提供：
  • 任务 ID
  • 错误信息
  • 请求参数（隐藏敏感信息）
  • 问题描述

​
状态监控

建议实现以下监控措施以及时发现和处理问题：
class VEOMonitor:
    def __init__(self):
        self.success_count = 0
        self.failure_count = 0
        self.total_duration = 0
        
    def record_success(self, duration):
        self.success_count += 1
        self.total_duration += duration
        
    def record_failure(self, error_code):
        self.failure_count += 1
        # 记录错误类型用于分析
        
    def get_success_rate(self):
        total = self.success_count + self.failure_count
        return self.success_count / total if total > 0 else 0
        
    def get_average_duration(self):
        return self.total_duration / self.success_count if self.success_count > 0 else 0