{
  "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/submit
提交视频生成任务

​
请求参数

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

​
请求示例

curl -X POST "https://api.apiyi.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}
查询视频生成状态

​
路径参数

​
taskId
string
required
任务 ID（从提交接口返回）

​
请求示例

curl -X GET "https://api.apiyi.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"
  }
}

​
状态说明

状态说明下一步操作
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