跳转到主要内容
⚠️ 此文档为旧版自定义 API，不推荐使用请查看新版: Veo-3.1 快速开始

​
提交视频任务

/veo/v1/api/video/submit 提交视频生成任务

​
请求参数

prompt string 必填 视频生成的文本描述 model string 默认值:“veo3” 模型名称。可选值：
  • veo3 - 标准版
  • veo3-fast - 快速版
  • veo3-pro - 专业版
  • veo3-pro-frames - 专业版+帧控制
images array 参考图片 URL 数组，最多 5 张 enhance_prompt boolean 默认值:false 是否增强提示词

​
请求示例

cURL Python JavaScript 
curl -X POST "https://api.yelinai.com/veo/v1/api/video/submit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "prompt": "一只猫咪在雨夜散步，准备抓一只老鼠",
    "model": "veo3",
    "images": ["https://example.com/cat.png"],
    "enhance_prompt": true
  }'

​
响应示例

成功响应 
{
  "success": true,
  "data": {
    "taskId": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
    "pollingUrl": "https://asyncdata.net/source/veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
    "status": "processing",
    "message": "Task submitted successfully"
  }
}

​
查询任务状态

/veo/v1/api/video/status/ 查询视频生成状态

​
路径参数

taskId string 必填 任务 ID（从提交接口返回）

​
请求示例

cURL Python JavaScript 
curl -X GET "https://api.yelinai.com/veo/v1/api/video/status/veo3:b873872e-7358-4c2f-8d55-bd23f000e14e" \
  -H "Authorization: Bearer your-api-key"

​
响应状态

  • 任务提交
  • 图片下载中
  • 视频生成中
  • 生成完成
{
  "success": true,
  "data": {
    "taskId": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
    "pollingUrl": "https://asyncdata.net/source/veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
    "status": "processing",
    "message": "Task submitted successfully"
  }
}

{
  "success": true,
  "data": {
    "taskId": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
    "pollingUrl": "https://asyncdata.net/source/veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
    "upstreamData": {
      "created_at": 1751704074528,
      "enhanced_prompt": "A cat is walking on a rainy night, preparing to catch a mouse",
      "id": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
      "images": [
        {
          "status": "downloading",
          "url": "https://tokensceshi.oss-ap-southeast-1.aliyuncs.com/sora/81ecb724-9e01-4f0e-a2ac-0c85802b8841.png"
        }
      ],
      "status": "image_downloading"
    },
    "status": "processing",
    "progress": {
      "upstreamStatus": "image_downloading",
      "retryCount": 0,
      "maxRetries": 3
    }
  }
}

{
  "success": true,
  "data": {
    "taskId": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
    "upstreamData": {
      "status": "video_generating",
      "video_generation_id": "f48aea86a9c27d4c8b15612b6c65d08e",
      "video_generation_status": "MEDIA_GENERATION_STATUS_ACTIVE"
    },
    "status": "processing"
  }
}

{
  "success": true,
  "data": {
    "taskId": "veo3:b873872e-7358-4c2f-8d55-bd23f000e14e",
    "status": "completed",
    "result": {
      "video_url": "https://filesystem.site/cdn/20250705/BFvep0SngrqIrN3yDSFChIXAz2mU0M.mp4",
      "video_media_id": "CAUSJGRlNzE5MzRhLTljMDgtNDE1Mi05NWVlLThjOTlhMTZlODUyYxokY2U4ZjNiYmUtNGFmZS00NTExLWI4ZDEtMGM1MTFkM2ZlNGIxIgNDQUUqJDJlNTY3OWUyLWQ2YmQtNGVlZS05ZTUwLWMyMWE0MWU3ZDYzNw"
    }
  }
}

​
状态说明

状态说明下一步操作
processing任务处理中继续轮询状态
completed生成完成获取视频 URL
failed生成失败检查错误信息

​
HTTP 状态码

200 成功 请求成功 400 客户端错误 请求参数错误，检查参数格式和必填项 401 认证错误 认证失败，检查 API 密钥是否正确 500 服务器错误 服务器内部错误，请稍后重试或联系支持

​
错误响应格式

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

​
常见错误码

错误码说明解决方案
INVALID_PROMPT提示词无效检查提示词长度和内容
INVALID_MODEL模型不存在使用支持的模型名称
QUOTA_EXCEEDED配额超限联系增加配额
TASK_NOT_FOUND任务不存在检查任务 ID