> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yelinai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 错误处理（自定义 API - 已过时）

> VEO API 的错误处理、限制说明和常见问题解决 - 旧版文档

**⚠️ 此文档为旧版自定义 API，不推荐使用**请查看新版: [Veo-3.1 问题排查](/api-capabilities/veo/veo-31-troubleshooting)

## 限制说明

了解 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 状态

1

检查任务时长

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

2

验证任务 ID

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

3

检查 API 状态

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

4

重试提交

如果超过 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

## 技术支持

## 遇到问题？

如果您遇到文档中未涵盖的问题，请通过以下方式联系我们：

* **邮箱：** [threezhang.cn@gmail.com](mailto:threezhang.cn@gmail.com)
* **微信：** Kikivivikids
* **Telegram：** [https://t.me/laozhang\_cn](https://t.me/laozhang_cn)
* **响应时间：** 工作日 24 小时内

联系时请提供：

* 任务 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
```