VEO 视频生成常见问题 VEO 3.1 API 的常见问题解答

常见问题解答

分辨率和尺寸

后台和系统相关

技术规格

视频参数参数竖屏模式横屏模式分辨率 720 × 1280 1280 × 720 宽高比 9:16 16:9 时长 8 秒 8 秒音轨自带自带

帧转视频要求使用帧转视频模式（-fl 模型）时：开始帧图片：必传，仅限一张结束帧图片：可选，如果不传则自动生成过渡效果图片格式：支持 URL 或 base64 编码图片大小：建议不超过 10MB

错误处理

常见错误

最佳实践

提示词优化示例对比：不好的提示词好的提示词 ”一只猫" "一只橘色的小猫在阳光明媚的花园里慢慢走动" "跑步" "一个运动员在晨光中沿着海滨大道快速奔跑" "飞" "一只雄鹰展开双翼在雪山之巅翱翔”

异步调用最佳实践

Copy import requests import time

def generate_video_async(prompt, model="veo-3.1-fast"): """异步生成视频的完整流程"""

# 1. 创建任务
response = requests.post(
    "https://api.apiyi.com/v1/videos",
    headers={"Authorization": "sk-your-api-key"},
    json={"prompt": prompt, "model": model}
)
video_id = response.json()["id"]
print(f"任务创建成功，ID: {video_id}")

# 2. 轮询状态
max_attempts = 60  # 最多轮询 60 次（5分钟）
for attempt in range(max_attempts):
    response = requests.get(
        f"https://api.apiyi.com/v1/videos/{video_id}",
        headers={"Authorization": "sk-your-api-key"}
    )
    status = response.json()["status"]

    if status == "completed":
        print("视频生成完成！")
        break
    elif status == "failed":
        print("视频生成失败")
        return None

    print(f"生成中... ({attempt + 1}/{max_attempts})")
    time.sleep(5)

# 3. 获取视频
response = requests.get(
    f"https://api.apiyi.com/v1/videos/{video_id}/content",
    headers={"Authorization": "sk-your-api-key"}
)
video_url = response.json()["url"]
print(f"视频 URL: {video_url}")

return video_url

使用示例

video_url = generate_video_async("画只猪在天上飞")

性能优化

选择合适的模型追求速度使用 -fast 模型，生成时间缩短约 40%，价格更低追求质量使用标准模型，画质更优，细节更丰富图片动画化使用 -fl 模型，支持首尾帧转视频横屏内容使用 landscape 模型，适合桌面播放

生成速度对比模型类型平均生成时间价格推荐场景 -fast 模型 30-60 秒 $0.15 快速测试、批量生成标准模型 1-2 分钟 $0.25 高质量内容、正式发布提示： VEO 3.1 的生成速度比 Sora 2 快 50%！

获取帮助如果您遇到其他问题，可以通过以下方式获取帮助：发送邮件联系技术支持：feedback@apiyi.com 查看文档返回 VEO 3.1 文档首页查看示例查看更多代码示例模型定价了解详细定价信息

使用示例 ​

使用示例