VideoPilot API 套件使用户能够通过提示将参考视频转化为重新创作的作品。同时，用户可以对重新创作视频的关键参数施加约束或引导，这些参数包括场景、角色、动作、风格和相机设置。此外，该 API 套件允许通过提示和反馈来提升视频质量，它会根据用户反馈重新生成特定的视频片段，以提高质量或使视频更符合用户意图。

Endpoints

ImitateAndGenerateVideo

根据参考视频和可选的参考图像，按照用户的编辑指令生成新视频。

Parameters

Response

Example API Usage

curl --location "https://prompt-pilot.cn-beijing.volces.com/video-pilot?Version=1.0&Action=ImitateAndGenerateVideo" \
--header "Authorization: Bearer {VIDEO_PILOT_API_KEY}" \
--header "Content-Type: application/json" \
--data '{
    "RequestId": "'$(uuidgen)'",
    "WorkspaceId": "{VIDEO_PILOT_WORKSPACE_ID}",
    "RefVideoUrl": "https://link/to/your/video/ or data:video/mp4;base64,...",
    "UserMessage": "Anime Girl Instead",
    "RefImages": ["data:image/png;base64,..."],
    "Model": "doubao-seedance-1-0-pro-250528",
    "TimeBudget": 2,
    "VideoRatio": "16:9",
    "VideoResolution": "1080p"
}'

Example Return

{"Result":{"TaskId":"vgt-2025103112362-ASDFG"},"Error":null}

GetTaskResult

检索已完成任务的生成结果。

Parameters

Response

TaskObject:

VideoSegmentObject

Example API Usage

curl --location "https://prompt-pilot.cn-beijing.volces.com/video-pilot?Version=1.0&Action=GetTaskResult" \
--header "Authorization: Bearer {VIDEO_PILOT_API_KEY}" \
--header "Content-Type: application/json" \
--data '{
    "RequestId": "'$(uuidgen)'",
    "WorkspaceId": "{VIDEO_PILOT_WORKSPACE_ID}",
    "TaskId": "Your Task ID",
}'

Example Return - Pending

{"Result":{"TaskId":"Your Task ID","FullVideo":"","TaskStatus":"pending","VideoSegments":[]},"Error":null}

Example Return - Finished

{
  "Result": {
    "TaskId": "vgt-2025103112362-ASDFG",
    "FullVideo": "Video URL",
    "TaskStatus": "completed",
    "VideoSegments": [
      {
        "SegmentId": "vpv-2025104536724-ABCDE",
        "IndexInVideo": 0,
        "VideoURL": "Video URL",
        "KeyframeURL": "Keyframe URL",
        "ScenePrompt": "Your scene script",
        "VersionNum": 1
      },
      {
        "SegmentId": "vpv-20251031150729-3Au32",
        "IndexInVideo": 1,
        "VideoURL": "Video URL",
        "KeyframeURL": "Keyframe URL",
        "ScenePrompt": "Your scene script",
        "VersionNum": 1
      }
    ]
  },
  "Error": null
}

ListSegmentVersions

检索特定视频片段的所有历史版本或替代版本，例如通过多次迭代或重新生成所产生的版本。

Parameters

Response

Example API Usage

curl --location "https://prompt-pilot.cn-beijing.volces.com/video-pilot?Version=1.0&Action=ListSegmentVersions" \
--header "Authorization: Bearer {VIDEO_PILOT_API_KEY}" \
--header "Content-Type: application/json" \
--data '{
    "RequestId": "'$(uuidgen)'",
    "WorkspaceId": "{VIDEO_PILOT_WORKSPACE_ID}",
    "TaskId": "Your TaskId",
    "SegmentIndex": 0,
}'

Example Return

{
  "Result": {
    "VideoSegments": [
      {
        "SegmentId": "vpv-2025104536724-ABCDE",
        "IndexInVideo": 0,
        "VideoURL": "Video URL",
        "KeyframeURL": "Keyframe URL",
        "ScenePrompt": "Your scene script",
        "VersionNum": 1
      },
      {
        "SegmentId": "vpv-20251031150729-3Au32",
        "IndexInVideo": 0,
        "VideoURL": "Video URL",
        "KeyframeURL": "Keyframe URL",
        "ScenePrompt": "Your scene script",
        "VersionNum": 2
      }
    ]
  },
  "Error": null
}

ListTask

列出当前用户/会话的所有现有任务 ID。

Parameters

None.

Response

Example API Usage

curl --location "https://prompt-pilot.cn-beijing.volces.com/video-pilot?Version=1.0&Action=ListTask" \
--header "Authorization: Bearer {VIDEO_PILOT_API_KEY}" \
--header "Content-Type: application/json" \
--data '{
    "RequestId": "'$(uuidgen)'",
    "WorkspaceId": "{VIDEO_PILOT_WORKSPACE_ID}"
}'

Example Return

{
  "Result": {
    "Tasks": [
      {
        "TaskId": "vgt-20251120191558-ASDFG",
        "FullVideo": "Full Video URL",
        "TaskStatus": "completed",
        "VideoSegments": null
      },
      {
        "TaskId": "vgt-20251120191600-ASDFG",
        "FullVideo": "Full Video URL",
        "TaskStatus": "completed",
        "VideoSegments": null
      },
      {
        "TaskId": "vgt-20251120191615-8yM8X",
        "FullVideo": "",
        "TaskStatus": "failed",
        "VideoSegments": null
      }
    ]
  },
  "Error": null
}

RegenerateVideoSegmentFromFeedback

根据用户反馈重新生成特定视频片段，提高质量或使其更符合预期。

Parameters

Response

Example API Usage

curl --location "https://prompt-pilot.cn-beijing.volces.com/video-pilot?Version=1.0&Action=RegenerateVideoSegmentFromFeedback" \
--header "Authorization: Bearer {VIDEO_PILOT_API_KEY}" \
--header "Content-Type: application/json" \
--data '{
    "RequestId": "'$(uuidgen)'",
    "WorkspaceId": "{VIDEO_PILOT_WORKSPACE_ID}",
    "TaskId": "Your TaskId",
    "FeedbackMessage": "Add floating cats",
    "SegmentId": "Get it from get task result",
}'

Example Return

{"Result":{"TaskId":"Your Task ID"},"Error":null}

ExtractKeyFramesAndPlot

该 API 旨在通过提取视频关键帧和场景描述来源，构建热门视频的提示词库。

Parameters

• VideoURL: 可下载的链接（如来自 tos 的链接）或 base64 格式内容

Response

GetExtractKeyFramesAndPlotResult

Parameters

Response

响应将包含视频各片段的首帧、末帧及对应的场景提示词，结构如下：
响应将包含视频各片段的首帧、末帧及对应的场景提示词，结构如下：

RefVideoSegmentObject

典型用法

1. 若需通过批量模仿生成视频，可使用imitate_and_generate_video接口。

该 API 会还原参考视频的细节，同时应用你提供的指令创建新视频。
为获得最佳效果，建议提供一张参考图片，用于指导视觉风格或主体特征。
任务完成后，可通过get_task_result接口获取生成的视频输出。

2. 若需微调或优化生成视频的特定部分，可使用regenerate_video_segment_from_feedback接口。

该接口接收用户反馈，仅重新生成选中的片段，并根据你的输入进行优化。
对于需要多次尝试才能达到理想效果的复杂视频片段，该接口尤为实用。

AgenticShortVideoGeneration

智能短视频生成功能可自动处理多张参考图片，用于视频生成。

Parameters

Response

响应将包含异步视频生成任务的唯一标识，结构如下：