跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

本文将介绍 Veo Extend API 的对接说明。该接口用于对一段已经生成的 Veo 视频进行时长延展,AI 会自动续写后续画面。

申请流程

要使用 API,需要先到 Veo 服务对应页面申请。如果你尚未登录或注册,会自动跳转到登录页面。

基本使用

调用本接口需要传入下列参数:
  • video_id(必填):来源视频的任务 ID(来自 /veo/videos 或本接口本身)。
  • model(必填):用于延展的模型,仅支持 veo31-fastveo31 两个模型,其他模型上游不支持。
  • prompt(选填):用于引导延展段画面的文字提示。
请求示例:
curl -X POST 'https://api.xhuoapi.ai/v1/veo/extend' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "video_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11",
    "model": "veo31-fast",
    "prompt": "the camera slowly zooms out to reveal more of the landscape"
  }'
返回结果与 /veo/videos 相同:
{
  "success": true,
  "task_id": "5fa2d9a6-7e54-481b-a4b0-3dc6f25dd2ab",
  "data": [
    {
      "id": "9b6f3b6b9c45419fbf2e3fe2f10b2b3a",
      "video_url": "https://platform.cdn.xhuoapi.ai/veo/5fa2d9a6.mp4",
      "created_at": "2025-07-25 16:07:43",
      "complete_at": "2025-07-25 16:10:28",
      "state": "succeeded"
    }
  ]
}

重要限制

来自 /veo/extend 的延展结果视频可以继续被 /veo/extend 再次延展,但是不能再被以下接口处理:
  • /veo/reshoot —— 不能换镜头运动
  • /veo/objects —— 不能再做物体增删
如果传入的 video_id 是延展结果,相关接口会返回 400 错误,请改用原始视频作为来源。

计费说明

  • model=veo31-fast:1.20 Credit / 次
  • model=veo31:7.64 Credit / 次

异步回调

接口支持异步模式,传入 callback_url 即可在任务完成后通过 POST 请求回调结果。