1e228a04dc
独立 /api/plan/v3 Seedream、Seedance 插件，并同步宿主能力默认值与渠道识别，避免与官方 /api/v3 凭证混用。 Co-authored-by: Cursor <cursoragent@cursor.com>
44 lines
1.7 KiB
Markdown
44 lines
1.7 KiB
Markdown
# 火山方舟 Agent Plan 视频任务
|
|
|
|
本插件使用 Agent Plan 专属 Contents Generations Tasks 异步接口。提示词、参考图、参考视频和参考音频组成 `content[]`；比例、分辨率、时长、生成音频和水印位于顶层任务参数。请求体与官方 Ark Seedance 一致，入口改为 `/api/plan/v3`。
|
|
|
|
## 接口与鉴权
|
|
|
|
{{OPERATIONS}}
|
|
|
|
```http
|
|
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 个音频。参考素材可以组合使用，但上游不支持纯音频或“文本 + 音频”。
|
|
|
|
## 官方资料
|
|
|
|
- [火山方舟 Agent Plan 文档](https://www.volcengine.com/docs/82379/2375486)
|
|
- [火山方舟内容生成任务文档](https://www.volcengine.com/docs/82379/1520757)
|
|
|
|
{{CONTRACT}}
|