Documentation Index
Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
Use this file to discover all available pages before exploring further.
⚠️ 此文档为旧版自定义 API，不推荐使用新版入口为 Veo-3.1 问题排查，但 Veo-3.1 旧接入方案自 2026 年 5 月 14 日起暂时无法使用。当前请先按线路故障处理，不要把当前故障误判为旧版自定义 API 的参数问题。 限制说明
API 限制
| 限制项 | 限制值 | 说明 |
|---|
| 提示词长度 | 2000 字符 | 建议控制在 1000 字符以内获得最佳效果 |
| 参考图片数量 | 最多 5 张 | 每张图片不超过 10MB |
| 并发任务数 | 10 个 | 超出将返回 429 错误 |
| 任务超时时间 | 30 分钟 | 超时任务将自动取消 |
| 视频时长 | 10-15 秒 | 根据模型不同有所差异 |
| 请求频率 | 100 次/分钟 | 超出限制将被限流 |
图片格式要求
- JPEG (.jpg, .jpeg)
- PNG (.png)
- WebP (.webp)
- 文件大小： 单张不超过 10MB
- 推荐分辨率： 1024x1024 或更高
- 颜色模式： RGB
- URL 要求： 必须是可公开访问的 HTTPS 链接
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 状态
检查任务时长
确认是否超过正常处理时间（见模型说明）
检查 API 状态
访问状态页面或联系支持确认服务状态
重试提交
如果超过 30 分钟，任务可能已超时，请重新提交
生成质量不理想
# 优化前
prompt = "猫"
# 优化后
prompt = """
一只橘色的英短猫在阳光明媚的客厅里，
慵懒地躺在柔软的沙发上，
午后的阳光透过窗户洒在它身上，
4K画质，温暖色调
"""
# 添加高质量参考图片
images = [
"https://example.com/cat-reference-1.jpg",
"https://example.com/cat-reference-2.jpg"
]
# 启用提示词增强
enhance_prompt = True
# 高质量需求选择 Pro 版本
model = "veo3-pro"
网络错误处理
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
