From f030204541611256fecf7241c9a9babef1b0408a Mon Sep 17 00:00:00 2001 From: ddcat666 <26564566+ddcat666@users.noreply.github.com> Date: Fri, 2 Oct 2026 18:10:34 +0800 Subject: [PATCH] =?UTF-8?q?feat(media):=20Dola-pool=20=E8=A7=86=E9=A2=91?= =?UTF-8?q?=E6=8F=92=E4=BB=B6=20-=20=E6=96=B0=E5=A2=9E=E7=8B=AC=E7=AB=8B?= =?UTF-8?q?=20Seedance=20=E4=BB=BB=E5=8A=A1=E5=8D=8F=E8=AE=AE=E5=B9=B6?= =?UTF-8?q?=E9=81=BF=E5=85=8D=20Kling=20=E8=BD=AE=E8=AF=A2=E8=B7=AF?= =?UTF-8?q?=E5=BE=84=E4=B8=8D=E5=85=BC=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 Dola-pool 官方插件包，按其接口文档配置创建、轮询和视频下载路径，并补充显式 duration、参考图映射与协议契约测试。 --- .../internal/protocol/dola_pool_video_test.go | 82 +++++ plugin-packages/dola-pool.yingce-plugin | Bin 0 -> 7775 bytes plugin-packages/dola-pool/README.md | 7 + plugin-packages/dola-pool/docs/interface.md | 297 ++++++++++++++++++ plugin-packages/dola-pool/manifest.json | 258 +++++++++++++++ 5 files changed, 644 insertions(+) create mode 100644 backend/internal/protocol/dola_pool_video_test.go create mode 100644 plugin-packages/dola-pool.yingce-plugin create mode 100644 plugin-packages/dola-pool/README.md create mode 100644 plugin-packages/dola-pool/docs/interface.md create mode 100644 plugin-packages/dola-pool/manifest.json diff --git a/backend/internal/protocol/dola_pool_video_test.go b/backend/internal/protocol/dola_pool_video_test.go new file mode 100644 index 000000000..dd4585ec3 --- /dev/null +++ b/backend/internal/protocol/dola_pool_video_test.go @@ -0,0 +1,82 @@ +package protocol + +import ( + "context" + "testing" +) + +func TestOfficialDolaPoolVideoProfile(t *testing.T) { + adapter := officialPackageAdapter(t, "dola-pool.yingce-plugin", "dola-pool") + request := GenerationRequest{ + Capability: CapabilityVideo, + Model: "seedance-2.5", + Prompt: "A cat chasing butterflies in a meadow", + Duration: 30, + AspectRatio: "720x1280", + Images: []MediaReference{{URL: "https://assets.example/character.png", Kind: "image"}}, + } + + create, err := adapter.BuildCreate(context.Background(), RequestContext{Request: request}) + if err != nil { + t.Fatal(err) + } + if create.Method != "POST" || create.Path != "/v1/videos/generations" || create.ContentType != "application/json" { + t.Fatalf("Dola-pool create = %#v", create) + } + body := manifestTestBody(t, create) + if body["model"] != request.Model || body["prompt"] != request.Prompt || body["duration"] != float64(30) { + t.Fatalf("Dola-pool create body = %#v", body) + } + if body["ratio"] != request.AspectRatio || body["size"] != request.AspectRatio { + t.Fatalf("Dola-pool frame fields = %#v", body) + } + images, _ := body["reference_images"].([]any) + if len(images) != 1 || images[0] != request.Images[0].URL { + t.Fatalf("Dola-pool reference_images = %#v", images) + } + + created, err := adapter.ParseCreate(context.Background(), []byte(`{"id":"video-task-1","status":"queued"}`)) + if err != nil { + t.Fatal(err) + } + if created.TaskID != "video-task-1" || created.Status != StatusPending { + t.Fatalf("Dola-pool create result = %#v", created) + } + poll, err := adapter.BuildPoll(context.Background(), PollContext{TaskID: created.TaskID}) + if err != nil { + t.Fatal(err) + } + if poll.Method != "GET" || poll.Path != "/v1/videos/video-task-1" { + t.Fatalf("Dola-pool poll = %#v", poll) + } + state, err := adapter.ParsePoll(context.Background(), PollContext{TaskID: created.TaskID}, []byte(`{"id":"video-task-1","status":"completed","video_url":"https://dolasd.xyz/videos/result.mp4"}`)) + if err != nil { + t.Fatal(err) + } + if state.Status != StatusSucceeded || state.Result == nil || len(state.Result.Videos) != 1 || state.Result.Videos[0].URL != "https://dolasd.xyz/videos/result.mp4" { + t.Fatalf("Dola-pool poll result = %#v", state) + } + + resultAdapter, ok := adapter.(ResultAdapter) + if !ok { + t.Fatal("Dola-pool adapter does not expose binary result download") + } + result, err := resultAdapter.BuildResult(context.Background(), PollContext{TaskID: created.TaskID}) + if err != nil { + t.Fatal(err) + } + if result.Method != "GET" || result.Path != "/v1/videos/video-task-1/content" || result.Headers["Accept"] != "video/mp4" { + t.Fatalf("Dola-pool result download = %#v", result) + } +} + +func TestOfficialDolaPoolRequiresExplicitDuration(t *testing.T) { + adapter := officialPackageAdapter(t, "dola-pool.yingce-plugin", "dola-pool") + _, err := adapter.BuildCreate(context.Background(), RequestContext{Request: GenerationRequest{ + Model: "seedance-2.5", + Prompt: "A cat chasing butterflies in a meadow", + }}) + if err == nil { + t.Fatal("Dola-pool accepted a request without an explicit duration") + } +} diff --git a/plugin-packages/dola-pool.yingce-plugin b/plugin-packages/dola-pool.yingce-plugin new file mode 100644 index 0000000000000000000000000000000000000000..6bad6b6e217131984522e0103cd0c9eddcde33dc GIT binary patch literal 7775 zcmZ{pV{j!v`{i$J+Y{TiZQHhOPRxllv5mR$#LkT|v29Jf^VU}F*8knw>gwvJyZU@N zAG+)J92I#8NK60#01IGM5i?YK_+^2D3IJG2002n;P9061Y^^NaJ(%p=ot>ujzSIdu zvAzU@hck}8dyT+eP}!bav4xxG%rA18r+M*(HqFeh^=in(UP6{tOmY4T^{!YUT>~@KN5-Y{b+sC z<}9(VvKV!pca@YkimgiVAoG`%_evl<=NYhR<;jh!K$o-TOPAX*QNz<(yOH(J%2Qtg zrp8wtH0T*9k}k=FKhMc{ml8;)*Shki-_~D|d04l!b0uNAY9?8>wvsN(aWxeruJpaN zbN#YVn$eoH^fQmdj$M9zO?t5(BdfED;>^FShlm52!a_4w$#Rykw5KR=jl-FG=p@+7 zQIyc#BIDxjO`2C7NM5R8$AtE4QuI_-#rTAiqU{IFL_xBAX!MX}-Q(@c<$zA?7)tQ3 zvLoC?6&tGxK85!5(^dPX?C{cyoGqHGv&L?}zVBGiU@wl@;50{7a}Oz4tC9bVRERER zOL&E{tJV=ERG*)KVl2YTIopZ>CAgSbTa2|SB$dtgL&*i`$V)xYcNQUgk1)}Xm!4%H z(lmGG#0)ierofX%(~hG_J|~14bs!6t!0UvOW?qFA*A!avKxZP6*O6SGnaP~qj%jQ6 zW}HZ0gN$Tsn$)MFP4bx*56LW^u1=)l*Qi`YHQDS&=n1*mGAVi8d2tq6Q^EY%yZNlX zHr9c)Zai4e{fAr%EJX*DU$r1WV9TH!-!yjQ?bD{|{Th6rN7_SvfVwV6Ma39(4@9Z` zfensv4TimQB9l-xV?emaW0RPpb$-1-#s2eJx>wT-(b`v|$=9ImJ~dxmUdJ`?q;P7_ z!O?S_4hz{O3V0bHrc^|U^q30r*gC>BeGh~w@;84>Z}xT0)QVl2VB73atblJ#8MYD+q5gdp`VU(z3HjQC=U0r-lpBNEU^k3Pr6D zg=jDDOp>!Cj6|4ud#vGkkCQ$)pXqA3oJyqS@ja}KTXfWD(W{rTF#iJ~v?UE_M)QuM z_ugJWBDgAf7$F*(n>1AwyfDr0 zaarH-Y5Zkc)?^_eYvVe6LqV!0fJtPQyNiGxaI`5O{BRqP5G&KHMqg=DjUYh&ckd$ri;M*N+{VN2` zQ12uyG36U5kKhJ+wsio)3C3Me0A;QVKf6#^IOHA9Efmbu)`T5(iq~`nr&HJwm>g>i zM^m-GY05d6a$`?hNsdMr?k6QB^hoMT-`Ntb78eiYDWA9hN#R4XPJE z?mH9Q9_dJUWi%1yW=slEk%V3r(%aC`wdl>JE~kQ2M?|w~j8h0Js#;IxU7-{C>8p$`}vt@O}Lf57KQ6<$&L`B>@jatwFczJzU=i z-f`ZmdU&QOKKC_;13KJds+1WHRUUU3xE?@ZP{~a0?>cC%j&2TNj(Qw2qe~+BySv4i z7o<#_9f)2b+7!AP&n5$Ii9w%%*JG{>RFsH&n=UKs+P5AY;@_4s3cNHOZax(!W|hdf z@!w@d-c*UN9pXZ+;p+cIgv+W0RuSORs{f;wypC%BLcLh>8$pL_Zi)tbwnn+&s5X)$ z!a)X%nPp)+Q8!bV$}#EoO8AR;jaGa?S-bhLN_%f5w z`(8UvyT-DNHBwasBR)}I)(2|R$M#Ei$mI%0DH7Q(@gSIQpAma|kk`PPFaRGwQ09F4WjC07p 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 literal 0 HcmV?d00001 diff --git a/plugin-packages/dola-pool/README.md b/plugin-packages/dola-pool/README.md new file mode 100644 index 000000000..66b4b00ca --- /dev/null +++ b/plugin-packages/dola-pool/README.md @@ -0,0 +1,7 @@ +# Dola-pool Seedance Video + +该独立视频协议插件对接 `https://dolasd.xyz` 的 Dola-pool 视频任务 API。 + +在渠道配置中选择 `Dola-pool Seedance Video`，填写 Dola-pool API Key。任务使用 `/v1/videos/generations` 创建、`/v1/videos/{task_id}` 查询；不要使用 Kling Video 插件，Kling 的轮询 URL 与 Dola-pool 不同。 + +接口细节见 [docs/interface.md](docs/interface.md)。 diff --git a/plugin-packages/dola-pool/docs/interface.md b/plugin-packages/dola-pool/docs/interface.md new file mode 100644 index 000000000..91a971886 --- /dev/null +++ b/plugin-packages/dola-pool/docs/interface.md @@ -0,0 +1,297 @@ +# Dola-pool Seedance Video 接口 + +## 协议身份 + +- 插件 ID / Provider ID：`dola-pool` +- 默认 Base URL：`https://dolasd.xyz` +- 鉴权：`Authorization: Bearer ` +- 创建：`POST /v1/videos/generations` +- 查询：`GET /v1/videos/{task_id}` +- 下载：`GET /v1/videos/{task_id}/content` + +## 创建请求 + +插件以 JSON 发送 `model`、`prompt` 和 `duration`。时长必须显式提供，不要依赖服务端默认值；只提交 `GET /v1/models` 中该模型当前开放的 `durations`。接口当前示例档位为 `seedance-2.5`、30 秒，开放档位由服务端定价配置控制。 + +`aspectRatio` 同时映射到 `ratio` 和 `size`，因此可填写比例（如 `16:9`、`9:16`）或接口接受的像素尺寸（如 `720x1280`）。参考图映射至 `reference_images`，支持公网 HTTPS URL 或 `data:image/...;base64,...`。建议优先使用公网 URL，单图不超过 15 MB、最多 30 张，格式限 JPEG、PNG、WEBP。 + +额外请求字段可通过 `providerOptions.dola-pool.body` 或 `providerOptions.dola-pool.extra_body` 传入；扩展对象与标准字段合并，扩展对象中的同名字段优先。 + +## 轮询与下载 + +创建响应中的 `id` 是后续查询使用的任务 ID。状态为 `queued`、`processing`、`completed` 或 `failed`；插件将接口状态映射为平台统一状态。建议每 5 至 10 秒查询一次，至少持续 20 分钟再判定超时。`timeout` 或 `download` 类型失败在退款后仍可能于 20 分钟内补回为成功，期间应继续查询，避免重复提交。 + +完成后优先使用查询响应的 `video_url`。也可调用 `/v1/videos/{task_id}/content` 获取 `video/mp4` 二进制。视频及对应任务记录约保留 6 小时，请及时下载转存。 + +## 404 排查 + +Dola-pool 的任务按 API Key 隔离；创建与查询必须使用同一把 Key。任务记录也会在成片保留期结束后清理。Kling Video 插件的轮询路径是 `/v1/videos/generations/{task_id}`，而 Dola-pool 要求 `/v1/videos/{task_id}`，因此两者不能互换。 + +错误响应使用 `{ "detail": "错误原因" }`。其他状态码与参数限制以 Dola-pool 接口文档及 `/v1/models` 当前返回为准。 + + +## Manifest 完整接口定义 + +以下 JSON 与插件包内实际 `manifest.json` 逐字段一致，覆盖插件身份、权限、配置、鉴权、参数、校验、创建、Agent、查询、取消、结果下载、响应和 Agent 响应映射。`documentation` 字段的值就是当前完整文档；为避免文档在自身内部无限递归，JSON 中仅用等义占位文本表示正文。 + +```json +{ + "apiVersion": "yingce.plugin/v2", + "id": "dola-pool", + "name": "Dola-pool Seedance Video", + "version": "1.0.0", + "author": "Dola-pool / 影策", + "description": "Dola-pool Seedance 视频生成任务协议。", + "permissions": [ + "generation.run", + "media.read" + ], + "configuration": { + "fields": [ + { + "name": "apiKey", + "type": "secret", + "label": "API Key", + "required": true + } + ] + }, + "contributes": { + "providers": [ + { + "id": "dola-pool", + "label": "Dola-pool Seedance Video", + "capabilities": [ + "video" + ], + "scopes": [ + "admin.system-channel", + "user.custom-channel", + "canvas", + "creation", + "agent" + ], + "baseUrl": "https://dolasd.xyz", + "requiresPublicMediaUrls": true, + "auth": { + "type": "bearer", + "field": "apiKey" + }, + "parameters": [ + { + "name": "model", + "type": "string", + "required": true, + "mapping": "model", + "description": "模型 ID；按 GET /v1/models 返回的模型配置填写。" + }, + { + "name": "prompt", + "type": "string", + "required": true, + "mapping": "prompt", + "description": "视频提示词。" + }, + { + "name": "duration", + "type": "integer", + "required": true, + "mapping": "duration", + "description": "必须显式传当前开放的时长档位；开放档位见 GET /v1/models。" + }, + { + "name": "aspectRatio", + "type": "string", + "required": false, + "mapping": "ratio/size", + "description": "画幅比例别名或受支持的像素尺寸。" + }, + { + "name": "images", + "type": "media[]", + "required": false, + "mapping": "reference_images", + "description": "参考图片；通过公网 URL 或 data URL 发送。" + }, + { + "name": "providerOptions", + "type": "object", + "required": false, + "mapping": "provider-specific fields", + "description": "Dola-pool 专属扩展字段。" + } + ], + "validations": [ + { + "assert": { + "$gt": [ + { + "$ref": "request.duration" + }, + 0 + ] + }, + "message": "Dola-pool 视频任务必须显式指定大于 0 的 duration" + } + ], + "create": { + "method": "POST", + "path": "/v1/videos/generations", + "contentType": "application/json", + "body": { + "$merge": [ + { + "model": { + "$ref": "request.model" + }, + "prompt": { + "$ref": "request.prompt" + }, + "duration": { + "$ref": "request.duration" + }, + "ratio": { + "$omitEmpty": { + "$ref": "request.aspectRatio" + } + }, + "size": { + "$omitEmpty": { + "$ref": "request.aspectRatio" + } + }, + "reference_images": { + "$omitEmpty": { + "$map": { + "from": { + "$sortByOrder": { + "$ref": "request.images" + } + }, + "as": "media", + "in": { + "$ref": "media.value" + } + } + } + } + }, + { + "$coalesce": [ + { + "$ref": "request.providerOptions.dola-pool.body" + }, + { + "$ref": "request.providerOptions.dola-pool.extra_body" + }, + {} + ] + } + ] + } + }, + "poll": { + "method": "GET", + "path": "/v1/videos/{{taskId}}", + "contentType": "application/json" + }, + "result": { + "method": "GET", + "path": "/v1/videos/{{taskId}}/content", + "headers": { + "Accept": "video/mp4" + } + }, + "response": { + "taskId": { + "$coalesce": [ + { + "$ref": "response.id" + }, + { + "$ref": "response.task_id" + }, + { + "$ref": "response.taskId" + }, + { + "$ref": "response.data.id" + }, + { + "$ref": "taskId" + } + ] + }, + "status": { + "$coalesce": [ + { + "$ref": "response.status" + }, + { + "$ref": "response.state" + }, + { + "$ref": "response.data.status" + }, + "pending" + ] + }, + "message": { + "$coalesce": [ + { + "$ref": "response.error" + }, + { + "$ref": "response.detail" + }, + { + "$ref": "response.message" + }, + { + "$ref": "response.fail_reason" + } + ] + }, + "videos": { + "$coalesce": [ + { + "$ref": "response.video_url" + }, + { + "$ref": "response.content.video_url" + }, + { + "$ref": "response.videoUrl" + }, + { + "$ref": "response.result_url" + }, + { + "$ref": "response.url" + }, + { + "$ref": "response.data.video_url" + }, + { + "$ref": "response.output.url" + } + ] + }, + "errorPaths": [ + "detail", + "error.code" + ], + "messagePaths": [ + "error", + "detail", + "message" + ], + "resultEphemeral": true + } + } + ] + }, + "documentation": "<当前插件的完整 documentation，由 README.md 与 docs/interface.md 拼接而成；为避免 JSON 递归，此处不重复展开正文。>" +} +``` + diff --git a/plugin-packages/dola-pool/manifest.json b/plugin-packages/dola-pool/manifest.json new file mode 100644 index 000000000..da49b02c7 --- /dev/null +++ b/plugin-packages/dola-pool/manifest.json @@ -0,0 +1,258 @@ +{ + "apiVersion": "yingce.plugin/v2", + "id": "dola-pool", + "name": "Dola-pool Seedance Video", + "version": "1.0.0", + "author": "Dola-pool / 影策", + "description": "Dola-pool Seedance 视频生成任务协议。", + "permissions": [ + "generation.run", + "media.read" + ], + "configuration": { + "fields": [ + { + "name": "apiKey", + "type": "secret", + "label": "API Key", + "required": true + } + ] + }, + "contributes": { + "providers": [ + { + "id": "dola-pool", + "label": "Dola-pool Seedance Video", + "capabilities": [ + "video" + ], + "scopes": [ + "admin.system-channel", + "user.custom-channel", + "canvas", + "creation", + "agent" + ], + "baseUrl": "https://dolasd.xyz", + "requiresPublicMediaUrls": true, + "auth": { + "type": "bearer", + "field": "apiKey" + }, + "parameters": [ + { + "name": "model", + "type": "string", + "required": true, + "mapping": "model", + "description": "模型 ID；按 GET /v1/models 返回的模型配置填写。" + }, + { + "name": "prompt", + "type": "string", + "required": true, + "mapping": "prompt", + "description": "视频提示词。" + }, + { + "name": "duration", + "type": "integer", + "required": true, + "mapping": "duration", + "description": "必须显式传当前开放的时长档位；开放档位见 GET /v1/models。" + }, + { + "name": "aspectRatio", + "type": "string", + "required": false, + "mapping": "ratio/size", + "description": "画幅比例别名或受支持的像素尺寸。" + }, + { + "name": "images", + "type": "media[]", + "required": false, + "mapping": "reference_images", + "description": "参考图片；通过公网 URL 或 data URL 发送。" + }, + { + "name": "providerOptions", + "type": "object", + "required": false, + "mapping": "provider-specific fields", + "description": "Dola-pool 专属扩展字段。" + } + ], + "validations": [ + { + "assert": { + "$gt": [ + { + "$ref": "request.duration" + }, + 0 + ] + }, + "message": "Dola-pool 视频任务必须显式指定大于 0 的 duration" + } + ], + "create": { + "method": "POST", + "path": "/v1/videos/generations", + "contentType": "application/json", + "body": { + "$merge": [ + { + "model": { + "$ref": "request.model" + }, + "prompt": { + "$ref": "request.prompt" + }, + "duration": { + "$ref": "request.duration" + }, + "ratio": { + "$omitEmpty": { + "$ref": "request.aspectRatio" + } + }, + "size": { + "$omitEmpty": { + "$ref": "request.aspectRatio" + } + }, + "reference_images": { + "$omitEmpty": { + "$map": { + "from": { + "$sortByOrder": { + "$ref": "request.images" + } + }, + "as": "media", + "in": { + "$ref": "media.value" + } + } + } + } + }, + { + "$coalesce": [ + { + "$ref": "request.providerOptions.dola-pool.body" + }, + { + "$ref": "request.providerOptions.dola-pool.extra_body" + }, + {} + ] + } + ] + } + }, + "poll": { + "method": "GET", + "path": "/v1/videos/{{taskId}}", + "contentType": "application/json" + }, + "result": { + "method": "GET", + "path": "/v1/videos/{{taskId}}/content", + "headers": { + "Accept": "video/mp4" + } + }, + "response": { + "taskId": { + "$coalesce": [ + { + "$ref": "response.id" + }, + { + "$ref": "response.task_id" + }, + { + "$ref": "response.taskId" + }, + { + "$ref": "response.data.id" + }, + { + "$ref": "taskId" + } + ] + }, + "status": { + "$coalesce": [ + { + "$ref": "response.status" + }, + { + "$ref": "response.state" + }, + { + "$ref": "response.data.status" + }, + "pending" + ] + }, + "message": { + "$coalesce": [ + { + "$ref": "response.error" + }, + { + "$ref": "response.detail" + }, + { + "$ref": "response.message" + }, + { + "$ref": "response.fail_reason" + } + ] + }, + "videos": { + "$coalesce": [ + { + "$ref": "response.video_url" + }, + { + "$ref": "response.content.video_url" + }, + { + "$ref": "response.videoUrl" + }, + { + "$ref": "response.result_url" + }, + { + "$ref": "response.url" + }, + { + "$ref": "response.data.video_url" + }, + { + "$ref": "response.output.url" + } + ] + }, + "errorPaths": [ + "detail", + "error.code" + ], + "messagePaths": [ + "error", + "detail", + "message" + ], + "resultEphemeral": true + } + } + ] + }, + "documentation": "# Dola-pool Seedance Video\n\n该独立视频协议插件对接 `https://dolasd.xyz` 的 Dola-pool 视频任务 API。\n\n在渠道配置中选择 `Dola-pool Seedance Video`，填写 Dola-pool API Key。任务使用 `/v1/videos/generations` 创建、`/v1/videos/{task_id}` 查询；不要使用 Kling Video 插件，Kling 的轮询 URL 与 Dola-pool 不同。\n\n接口细节见 [docs/interface.md](docs/interface.md)。\n\n---\n\n# Dola-pool Seedance Video 接口\n\n## 协议身份\n\n- 插件 ID / Provider ID：`dola-pool`\n- 默认 Base URL：`https://dolasd.xyz`\n- 鉴权：`Authorization: Bearer `\n- 创建：`POST /v1/videos/generations`\n- 查询：`GET /v1/videos/{task_id}`\n- 下载：`GET /v1/videos/{task_id}/content`\n\n## 创建请求\n\n插件以 JSON 发送 `model`、`prompt` 和 `duration`。时长必须显式提供，不要依赖服务端默认值；只提交 `GET /v1/models` 中该模型当前开放的 `durations`。接口当前示例档位为 `seedance-2.5`、30 秒，开放档位由服务端定价配置控制。\n\n`aspectRatio` 同时映射到 `ratio` 和 `size`，因此可填写比例（如 `16:9`、`9:16`）或接口接受的像素尺寸（如 `720x1280`）。参考图映射至 `reference_images`，支持公网 HTTPS URL 或 `data:image/...;base64,...`。建议优先使用公网 URL，单图不超过 15 MB、最多 30 张，格式限 JPEG、PNG、WEBP。\n\n额外请求字段可通过 `providerOptions.dola-pool.body` 或 `providerOptions.dola-pool.extra_body` 传入；扩展对象与标准字段合并，扩展对象中的同名字段优先。\n\n## 轮询与下载\n\n创建响应中的 `id` 是后续查询使用的任务 ID。状态为 `queued`、`processing`、`completed` 或 `failed`；插件将接口状态映射为平台统一状态。建议每 5 至 10 秒查询一次，至少持续 20 分钟再判定超时。`timeout` 或 `download` 类型失败在退款后仍可能于 20 分钟内补回为成功，期间应继续查询，避免重复提交。\n\n完成后优先使用查询响应的 `video_url`。也可调用 `/v1/videos/{task_id}/content` 获取 `video/mp4` 二进制。视频及对应任务记录约保留 6 小时，请及时下载转存。\n\n## 404 排查\n\nDola-pool 的任务按 API Key 隔离；创建与查询必须使用同一把 Key。任务记录也会在成片保留期结束后清理。Kling Video 插件的轮询路径是 `/v1/videos/generations/{task_id}`，而 Dola-pool 要求 `/v1/videos/{task_id}`，因此两者不能互换。\n\n错误响应使用 `{ \"detail\": \"错误原因\" }`。其他状态码与参数限制以 Dola-pool 接口文档及 `/v1/models` 当前返回为准。\n\n\n## Manifest 完整接口定义\n\n以下 JSON 与插件包内实际 `manifest.json` 逐字段一致，覆盖插件身份、权限、配置、鉴权、参数、校验、创建、Agent、查询、取消、结果下载、响应和 Agent 响应映射。`documentation` 字段的值就是当前完整文档；为避免文档在自身内部无限递归，JSON 中仅用等义占位文本表示正文。\n\n```json\n{\n \"apiVersion\": \"yingce.plugin/v2\",\n \"id\": \"dola-pool\",\n \"name\": \"Dola-pool Seedance Video\",\n \"version\": \"1.0.0\",\n \"author\": \"Dola-pool / 影策\",\n \"description\": \"Dola-pool Seedance 视频生成任务协议。\",\n \"permissions\": [\n \"generation.run\",\n \"media.read\"\n ],\n \"configuration\": {\n \"fields\": [\n {\n \"name\": \"apiKey\",\n \"type\": \"secret\",\n \"label\": \"API Key\",\n \"required\": true\n }\n ]\n },\n \"contributes\": {\n \"providers\": [\n {\n \"id\": \"dola-pool\",\n \"label\": \"Dola-pool Seedance Video\",\n \"capabilities\": [\n \"video\"\n ],\n \"scopes\": [\n \"admin.system-channel\",\n \"user.custom-channel\",\n \"canvas\",\n \"creation\",\n \"agent\"\n ],\n \"baseUrl\": \"https://dolasd.xyz\",\n \"requiresPublicMediaUrls\": true,\n \"auth\": {\n \"type\": \"bearer\",\n \"field\": \"apiKey\"\n },\n \"parameters\": [\n {\n \"name\": \"model\",\n \"type\": \"string\",\n \"required\": true,\n \"mapping\": \"model\",\n \"description\": \"模型 ID；按 GET /v1/models 返回的模型配置填写。\"\n },\n {\n \"name\": \"prompt\",\n \"type\": \"string\",\n \"required\": true,\n \"mapping\": \"prompt\",\n \"description\": \"视频提示词。\"\n },\n {\n \"name\": \"duration\",\n \"type\": \"integer\",\n \"required\": true,\n \"mapping\": \"duration\",\n \"description\": \"必须显式传当前开放的时长档位；开放档位见 GET /v1/models。\"\n },\n {\n \"name\": \"aspectRatio\",\n \"type\": \"string\",\n \"required\": false,\n \"mapping\": \"ratio/size\",\n \"description\": \"画幅比例别名或受支持的像素尺寸。\"\n },\n {\n \"name\": \"images\",\n \"type\": \"media[]\",\n \"required\": false,\n \"mapping\": \"reference_images\",\n \"description\": \"参考图片；通过公网 URL 或 data URL 发送。\"\n },\n {\n \"name\": \"providerOptions\",\n \"type\": \"object\",\n \"required\": false,\n \"mapping\": \"provider-specific fields\",\n \"description\": \"Dola-pool 专属扩展字段。\"\n }\n ],\n \"validations\": [\n {\n \"assert\": {\n \"$gt\": [\n {\n \"$ref\": \"request.duration\"\n },\n 0\n ]\n },\n \"message\": \"Dola-pool 视频任务必须显式指定大于 0 的 duration\"\n }\n ],\n \"create\": {\n \"method\": \"POST\",\n \"path\": \"/v1/videos/generations\",\n \"contentType\": \"application/json\",\n \"body\": {\n \"$merge\": [\n {\n \"model\": {\n \"$ref\": \"request.model\"\n },\n \"prompt\": {\n \"$ref\": \"request.prompt\"\n },\n \"duration\": {\n \"$ref\": \"request.duration\"\n },\n \"ratio\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.aspectRatio\"\n }\n },\n \"size\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.aspectRatio\"\n }\n },\n \"reference_images\": {\n \"$omitEmpty\": {\n \"$map\": {\n \"from\": {\n \"$sortByOrder\": {\n \"$ref\": \"request.images\"\n }\n },\n \"as\": \"media\",\n \"in\": {\n \"$ref\": \"media.value\"\n }\n }\n }\n }\n },\n {\n \"$coalesce\": [\n {\n \"$ref\": \"request.providerOptions.dola-pool.body\"\n },\n {\n \"$ref\": \"request.providerOptions.dola-pool.extra_body\"\n },\n {}\n ]\n }\n ]\n }\n },\n \"poll\": {\n \"method\": \"GET\",\n \"path\": \"/v1/videos/{{taskId}}\",\n \"contentType\": \"application/json\"\n },\n \"result\": {\n \"method\": \"GET\",\n \"path\": \"/v1/videos/{{taskId}}/content\",\n \"headers\": {\n \"Accept\": \"video/mp4\"\n }\n },\n \"response\": {\n \"taskId\": {\n \"$coalesce\": [\n {\n \"$ref\": \"response.id\"\n },\n {\n \"$ref\": \"response.task_id\"\n },\n {\n \"$ref\": \"response.taskId\"\n },\n {\n \"$ref\": \"response.data.id\"\n },\n {\n \"$ref\": \"taskId\"\n }\n ]\n },\n \"status\": {\n \"$coalesce\": [\n {\n \"$ref\": \"response.status\"\n },\n {\n \"$ref\": \"response.state\"\n },\n {\n \"$ref\": \"response.data.status\"\n },\n \"pending\"\n ]\n },\n \"message\": {\n \"$coalesce\": [\n {\n \"$ref\": \"response.error\"\n },\n {\n \"$ref\": \"response.detail\"\n },\n {\n \"$ref\": \"response.message\"\n },\n {\n \"$ref\": \"response.fail_reason\"\n }\n ]\n },\n \"videos\": {\n \"$coalesce\": [\n {\n \"$ref\": \"response.video_url\"\n },\n {\n \"$ref\": \"response.content.video_url\"\n },\n {\n \"$ref\": \"response.videoUrl\"\n },\n {\n \"$ref\": \"response.result_url\"\n },\n {\n \"$ref\": \"response.url\"\n },\n {\n \"$ref\": \"response.data.video_url\"\n },\n {\n \"$ref\": \"response.output.url\"\n }\n ]\n },\n \"errorPaths\": [\n \"detail\",\n \"error.code\"\n ],\n \"messagePaths\": [\n \"error\",\n \"detail\",\n \"message\"\n ],\n \"resultEphemeral\": true\n }\n }\n ]\n },\n \"documentation\": \"<当前插件的完整 documentation，由 README.md 与 docs/interface.md 拼接而成；为避免 JSON 递归，此处不重复展开正文。>\"\n}\n```\n\n" +}