Files
ttstd-infinite-canvas/backend/internal/protocol/docs/volcengine-ark-agent-plan-video.md
VicoHu 1e228a04dc feat(plugins): 方舟 Agent Plan - 新增图片与视频协议插件
独立 /api/plan/v3 Seedream、Seedance 插件,并同步宿主能力默认值与渠道识别,避免与官方 /api/v3 凭证混用。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-17 17:55:12 +08:00

1.7 KiB

火山方舟 Agent Plan 视频任务

本插件使用 Agent Plan 专属 Contents Generations Tasks 异步接口。提示词、参考图、参考视频和参考音频组成 content[];比例、分辨率、时长、生成音频和水印位于顶层任务参数。请求体与官方 Ark Seedance 一致,入口改为 /api/plan/v3。

接口与鉴权

{{OPERATIONS}}

POST {channel_base_url}/api/plan/v3/contents/generations/tasks
GET  {channel_base_url}/api/plan/v3/contents/generations/tasks/{task_id}
DELETE {channel_base_url}/api/plan/v3/contents/generations/tasks/{task_id}
Authorization: Bearer <AGENT_PLAN_API_KEY>
Content-Type: application/json

与官方 /api/v3 的差异:

项 官方 Ark Agent Plan
Base URL https://ark.cn-beijing.volces.com/api/v3 https://ark.cn-beijing.volces.com/api/plan/v3
API Key 推理接入控制台 Key Agent Plan 专属 Key
计费 推理后付费/项目额度 AFP 套餐抵扣
请求体 contents/generations/tasks 同左

参数与字段映射

{{PARAMETERS}}

全模态参考的素材映射如下:

  • 图片:{"type":"image_url","image_url":{"url":"..."},"role":"reference_image"}
  • 视频:{"type":"video_url","video_url":{"url":"..."},"role":"reference_video"}
  • 音频:{"type":"audio_url","audio_url":{"url":"..."},"role":"reference_audio"}

单次最多发送 9 张图片、3 个视频和 3 个音频。参考素材可以组合使用,但上游不支持纯音频或“文本 + 音频”。

官方资料

{{CONTRACT}}