From ecfbfc9b032ad95b8bba19de3cedf6a2794e8a4b Mon Sep 17 00:00:00 2001 From: Ace Data Cloud Dev Date: Sun, 11 Oct 2026 23:02:44 +0800 Subject: [PATCH 1/4] feat(third_party): add Kling plugin --- .cursor-plugin/marketplace.json | 5 ++ README.md | 1 + third_party/kling/.cursor-plugin/plugin.json | 31 ++++++++++ third_party/kling/CHANGELOG.md | 5 ++ third_party/kling/LICENSE | 21 +++++++ third_party/kling/README.md | 56 +++++++++++++++++++ third_party/kling/assets/logo.jpg | Bin 0 -> 17328 bytes third_party/kling/examples/first-run.md | 5 ++ third_party/kling/mcp.json | 11 ++++ third_party/kling/readme/README_zh_Hans.md | 42 ++++++++++++++ third_party/kling/skills/kling/SKILL.md | 14 +++++ 11 files changed, 191 insertions(+) create mode 100644 third_party/kling/.cursor-plugin/plugin.json create mode 100644 third_party/kling/CHANGELOG.md create mode 100644 third_party/kling/LICENSE create mode 100644 third_party/kling/README.md create mode 100644 third_party/kling/assets/logo.jpg create mode 100644 third_party/kling/examples/first-run.md create mode 100644 third_party/kling/mcp.json create mode 100644 third_party/kling/readme/README_zh_Hans.md create mode 100644 third_party/kling/skills/kling/SKILL.md diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index f0c3bd371..36a31faf2 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -543,6 +543,11 @@ "source": "third_party/square", "description": "Work with payments, orders, catalog, customers, and invoices." }, + { + "name": "kling", + "source": "third_party/kling", + "description": "Generate Kling videos and retrieve the finished clip." + }, { "name": "tailscale", "source": "third_party/tailscale", diff --git a/README.md b/README.md index 886849908..e8f955b30 100644 --- a/README.md +++ b/README.md @@ -100,6 +100,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc | `zoho-desk` | [Zoho Desk](third_party/zoho-desk/) | Cursor | Integrations | Work with tickets, contacts, tasks, and knowledge base articles in Zoho Desk. | | `zoho-books` | [Zoho Books](third_party/zoho-books/) | Cursor | Integrations | Work with contacts, invoices, estimates, and items in Zoho Books. | | `square` | [Square](third_party/square/) | Cursor | Integrations | Work with payments, orders, catalog, customers, and invoices. | +| `kling` | [Kling](third_party/kling/) | Ace Data Cloud Dev | Integrations | Generate Kling videos and retrieve the finished clip. | | `tailscale` | [Tailscale](third_party/tailscale/) | Cursor | Integrations | Let Grok Bot reach MCP servers on your private Tailscale network. On your own tailnet it joins as one tag:grokbot device; on your team's company tailnet, turned on by a team admin, it uses each member's own device. | | `highlevel` | [HighLevel](third_party/highlevel/) | Cursor | Integrations | Work with contacts, conversations, opportunities, calendars, and payments. | | `finary` | [Finary](third_party/finary/) | Cursor | Integrations | Read your net worth, accounts, holdings, spending, and budgets. | diff --git a/third_party/kling/.cursor-plugin/plugin.json b/third_party/kling/.cursor-plugin/plugin.json new file mode 100644 index 000000000..e085c1917 --- /dev/null +++ b/third_party/kling/.cursor-plugin/plugin.json @@ -0,0 +1,31 @@ +{ + "name": "kling", + "displayName": "Kling", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.13.0" + }, + "description": "Generate Kling videos and retrieve the finished clip.", + "author": { + "name": "Ace Data Cloud Dev", + "email": "dev@acedata.cloud" + }, + "homepage": "https://platform.acedata.cloud/models", + "repository": "https://github.com/AceDataCloud/KlingCursor", + "license": "MIT", + "logo": "assets/logo.jpg", + "keywords": [ + "kling", + "kling", + "video", + "acedatacloud", + "mcp" + ], + "category": "integrations", + "tags": [ + "kling", + "video", + "mcp" + ], + "mcpServers": "./mcp.json" +} diff --git a/third_party/kling/CHANGELOG.md b/third_party/kling/CHANGELOG.md new file mode 100644 index 000000000..cfd4c2536 --- /dev/null +++ b/third_party/kling/CHANGELOG.md @@ -0,0 +1,5 @@ +# Changelog + +## 1.0.0 + +- Initial Kling Cursor plugin using the existing Ace Data Cloud hosted MCP. diff --git a/third_party/kling/LICENSE b/third_party/kling/LICENSE new file mode 100644 index 000000000..64bb5cfce --- /dev/null +++ b/third_party/kling/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Ace Data Cloud + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/third_party/kling/README.md b/third_party/kling/README.md new file mode 100644 index 000000000..368948b37 --- /dev/null +++ b/third_party/kling/README.md @@ -0,0 +1,56 @@ +# Kling for Cursor + +Generate Kling videos and retrieve the finished clip. This standalone plugin reuses the [Ace Data Cloud kling MCP](https://github.com/AceDataCloud/MCPs/tree/main/kling) and includes a focused Agent skill. Available tools and limits come from the live MCP schema. + +[简体中文教程](readme/README_zh_Hans.md) · [Copyable first-run prompt](examples/first-run.md) · [Current pricing](https://platform.acedata.cloud/models) + +## 1. Search and install + +In Cursor 3.13 or later, open **Cursor Settings → Plugins**, search for **Kling**, confirm **Ace Data Cloud Dev** and the service logo, then click **Install**. You can also use `/add-plugin kling` in chat. If the official listing is not live, review this source under `~/.cursor/plugins/local/kling/`; local installation does not prove Marketplace publication. + +## 2. Get a service API key + +1. Sign in at [Ace Data Cloud Applications](https://platform.acedata.cloud/console/applications). +2. Open **General application** or a service-specific application. Copy an existing API key, or use **Manage Keys → Create** for a separate Cursor key. +3. Confirm Kling access, [current price](https://platform.acedata.cloud/models), and balance. If **Allowed APIs** restrictions are enabled, include /kling/videos, /kling/tasks. + +Use a service API key, not a platform management token. Do not put it in chat or source files. + +## 3. Configure the plugin + +Under **Dashboard → Plugins → Configure**, select **Kling** and set `ACEDATACLOUD_API_TOKEN` to the key string. Paste only the key; the plugin adds `Bearer `. Reconnect the MCP server if tools are missing. The hosted endpoint needs no local Python installation. + +```json +{ + "mcpServers": { + "kling": { + "type": "http", + "url": "https://kling.mcp.acedata.cloud/mcp", + "headers": { + "Authorization": "Bearer ${ACEDATACLOUD_API_TOKEN}" + } + } + } +} +``` + +## 4. Run the first example + +Open Cursor Agent and paste the [first-run prompt](examples/first-run.md). It asks for `kling_generate_video`, model `kling-v3-turbo` and mode std, duration 5 seconds, aspect_ratio 16:9. The sample prompt is `A teal cube on a cream table, gentle camera orbit, studio lighting, no text.`. Verify live model access and price before running. + +Submit with `kling_generate_video` once. Save the returned `task_id` and use `kling_get_task` with that same ID until terminal. Pending is not a completed video; open the returned result URL on success. Never regenerate merely to poll. + +Open the returned video and inspect it. In **Ace Data Cloud → Usage/Billing**, match this call to its deducted Credits record. The plugin is free; API calls follow current service pricing. + +## Troubleshooting + +| Symptom | Action | +| --- | --- | +| Plugin or tools are missing | Check the Kling listing, configure the key, and reconnect MCP. | +| 401 or 403 | Check key validity, service access, balance, and Allowed APIs; do not include `Bearer ` in the configured value. | +| Invalid model or argument | Use the live tool schema and a model this account can access. | +| Pending task | Query the original task ID; do not regenerate to poll. | +| 429, timeout, or 5xx | Inspect the original task and usage history before another paid submission. | +| Result URL will not open | Confirm a terminal success and use the URL returned by that call. | + +[Source](https://github.com/AceDataCloud/KlingCursor) · [Report a problem](https://github.com/AceDataCloud/KlingCursor/issues) · dev@acedata.cloud. The logo reuses an existing Ace Data Cloud integration asset. This tool plugin does not register a Cursor chat-model provider. diff --git a/third_party/kling/assets/logo.jpg b/third_party/kling/assets/logo.jpg new file mode 100644 index 0000000000000000000000000000000000000000..2445397cc9c17cdb71cfa66cb37cf4515b73957a GIT binary patch literal 17328 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 >l_bf>j%G~0jfYWs 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 H__6;516gno literal 0 HcmV?d00001 diff --git a/third_party/kling/examples/first-run.md b/third_party/kling/examples/first-run.md new file mode 100644 index 000000000..6ff130118 --- /dev/null +++ b/third_party/kling/examples/first-run.md @@ -0,0 +1,5 @@ +# First Kling run + +Copy this into Cursor Agent after installing and configuring the plugin. No key is included. + +> Use the kling MCP tool kling_generate_video for one video request. I checked the current Ace Data Cloud price and balance. Use model kling-v3-turbo if this account offers it. Set mode std, duration 5 seconds, aspect_ratio 16:9. Set prompt to A teal cube on a cream table, gentle camera orbit, studio lighting, no text.. Submit at most once, keep the task ID, query it using kling_get_task until terminal, and open the completed result. If pending, report the ID so I can resume without a second generation. diff --git a/third_party/kling/mcp.json b/third_party/kling/mcp.json new file mode 100644 index 000000000..4ef5c5682 --- /dev/null +++ b/third_party/kling/mcp.json @@ -0,0 +1,11 @@ +{ + "mcpServers": { + "kling": { + "type": "http", + "url": "https://kling.mcp.acedata.cloud/mcp", + "headers": { + "Authorization": "Bearer ${ACEDATACLOUD_API_TOKEN}" + } + } + } +} diff --git a/third_party/kling/readme/README_zh_Hans.md b/third_party/kling/readme/README_zh_Hans.md new file mode 100644 index 000000000..400c4e242 --- /dev/null +++ b/third_party/kling/readme/README_zh_Hans.md @@ -0,0 +1,42 @@ +# Cursor Kling 插件 + +Generate Kling videos and retrieve the finished clip. 插件复用 [Ace Data Cloud kling MCP](https://github.com/AceDataCloud/MCPs/tree/main/kling),并提供专用 Agent skill。实际工具参数和限制以在线 MCP schema 为准。 + +[English guide](../README.md) · [可复制的首跑提示词](../examples/first-run.md) · [当前价格](https://platform.acedata.cloud/models) + +## 1. 搜索安装 + +在 Cursor 3.13 或更新版本打开 **Cursor Settings → Plugins**,搜索 **Kling**,确认作者 **Ace Data Cloud Dev** 和服务图标后点击 **Install**。也可在聊天中输入 `/add-plugin kling`。若官方条目尚未出现,可在 `~/.cursor/plugins/local/kling/` 本地审查;本地安装不代表 Marketplace 已上架。 + +## 2. 获取服务 API Key + +1. 登录 [Ace Data Cloud 应用管理](https://platform.acedata.cloud/console/applications)。 +2. 打开 **General application** 或服务专用应用,复制已有 Key;也可通过 **Manage Keys → Create** 新建 Cursor 专用 Key。 +3. 确认 Kling 权限、[当前价格](https://platform.acedata.cloud/models)和余额。若启用了 **Allowed APIs**,允许 /kling/videos, /kling/tasks。 + +使用服务 API Key,不要用平台管理 token,也不要放在聊天或仓库文件中。 + +## 3. 配置插件 + +在 **Dashboard → Plugins → Configure** 选择 **Kling**,将 Key 原文填入 `ACEDATACLOUD_API_TOKEN`。插件会自行添加 `Bearer `,连接 `https://kling.mcp.acedata.cloud/mcp`;无需安装本地 Python 服务。工具未出现时重新连接 MCP。 + +## 4. 首次调用 + +在 Cursor Agent 中复制[首跑提示词](../examples/first-run.md)。它使用 `kling_generate_video`,模型 `kling-v3-turbo`,参数为 mode std, duration 5 seconds, aspect_ratio 16:9,prompt 为 `A teal cube on a cream table, gentle camera orbit, studio lighting, no text.`。执行前核对当前模型权限和价格;字段变化时以在线工具 schema 为准。 + +只用 `kling_generate_video` 提交一次,保存返回的 `task_id`,随后用同一 ID 调用 `kling_get_task` 直到终态。pending 不代表已完成;成功后打开结果地址。不要为轮询重新生成。 + +打开返回的video结果并检查。在 **Ace Data Cloud → Usage/Billing** 核对本次调用对应的 Credits 扣费;插件免费,API 按当前服务价格计费。 + +## 排障 + +| 现象 | 处理 | +| --- | --- | +| 找不到插件或工具 | 核对 Kling 条目、配置 Key 并重连 MCP。 | +| 401 或 403 | 检查 Key、服务权限、余额和 Allowed APIs;配置值不要带 `Bearer `。 | +| 模型或参数错误 | 以在线 MCP schema 和账户可用模型为准。 | +| 任务 pending | 沿原 task ID 查询,不要为轮询重新生成。 | +| 429、超时或 5xx | 先检查原任务和用量记录,再决定是否再次付费提交。 | +| 结果无法打开 | 确认终态成功,打开该次调用返回的地址。 | + +[源码](https://github.com/AceDataCloud/KlingCursor) · [问题反馈](https://github.com/AceDataCloud/KlingCursor/issues) · dev@acedata.cloud。图标复用 Ace Data Cloud 现有集成资源。本插件提供工具,不注册 Cursor 聊天模型 Provider。 diff --git a/third_party/kling/skills/kling/SKILL.md b/third_party/kling/skills/kling/SKILL.md new file mode 100644 index 000000000..5db87ed61 --- /dev/null +++ b/third_party/kling/skills/kling/SKILL.md @@ -0,0 +1,14 @@ +--- +name: kling +description: Use Kling through the Ace Data Cloud MCP server in Cursor. Use for Kling video work or an existing task query. +--- + +# Kling in Cursor + +This skill adapts the [existing Ace Data Cloud skill](https://github.com/AceDataCloud/Skills/tree/main/skills/kling-video). The live MCP schema is the source of truth for arguments and models. + +1. Check [current price, balance, and service access](https://platform.acedata.cloud/models) before a paid call. +2. Submit with `kling_generate_video` once. Save the returned `task_id` and use `kling_get_task` with that same ID until terminal. Pending is not a completed video; open the returned result URL on success. Never regenerate merely to poll. +3. Return the result, task ID if present, and any service error. Keep the API token out of chat and files. + +Configure `ACEDATACLOUD_API_TOKEN` under **Dashboard → Plugins → Configure**. See the [first-run guide](../../README.md). From 45cbf3874da64d8f1bdc2438f7d374524679c290 Mon Sep 17 00:00:00 2001 From: Ace Data Cloud Dev Date: Sun, 11 Oct 2026 23:28:16 +0800 Subject: [PATCH 2/4] fix(kling): declare API token variable --- third_party/kling/.cursor-plugin/plugin.json | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/third_party/kling/.cursor-plugin/plugin.json b/third_party/kling/.cursor-plugin/plugin.json index e085c1917..43e28e69a 100644 --- a/third_party/kling/.cursor-plugin/plugin.json +++ b/third_party/kling/.cursor-plugin/plugin.json @@ -27,5 +27,18 @@ "video", "mcp" ], + "variables": { + "type": "object", + "properties": { + "ACEDATACLOUD_API_TOKEN": { + "type": "string", + "title": "Ace Data Cloud API token", + "description": "Service API key from https://platform.acedata.cloud/console/applications with Kling access." + } + }, + "required": [ + "ACEDATACLOUD_API_TOKEN" + ] + }, "mcpServers": "./mcp.json" } From 32395f344b57a03375c84fca8d088e55161cc7e8 Mon Sep 17 00:00:00 2001 From: Ace Data Cloud Dev Date: Mon, 12 Oct 2026 01:08:26 +0800 Subject: [PATCH 3/4] docs: match Cursor 3.24 plugin navigation --- third_party/kling/README.md | 4 ++-- third_party/kling/readme/README_zh_Hans.md | 4 ++-- third_party/kling/skills/kling/SKILL.md | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/third_party/kling/README.md b/third_party/kling/README.md index 368948b37..b078ecf1f 100644 --- a/third_party/kling/README.md +++ b/third_party/kling/README.md @@ -6,7 +6,7 @@ Generate Kling videos and retrieve the finished clip. This standalone plugin reu ## 1. Search and install -In Cursor 3.13 or later, open **Cursor Settings → Plugins**, search for **Kling**, confirm **Ace Data Cloud Dev** and the service logo, then click **Install**. You can also use `/add-plugin kling` in chat. If the official listing is not live, review this source under `~/.cursor/plugins/local/kling/`; local installation does not prove Marketplace publication. +In Cursor 3.24, open **Customize → Browse Marketplace**, search for **Kling**, confirm **Ace Data Cloud Dev** and the service logo, then click **Add**. Older releases may put Plugins under Settings. You can also use `/add-plugin kling` in chat. If the official listing is not live, review this source under `~/.cursor/plugins/local/kling/`; local installation does not prove Marketplace publication. ## 2. Get a service API key @@ -18,7 +18,7 @@ Use a service API key, not a platform management token. Do not put it in chat or ## 3. Configure the plugin -Under **Dashboard → Plugins → Configure**, select **Kling** and set `ACEDATACLOUD_API_TOKEN` to the key string. Paste only the key; the plugin adds `Bearer `. Reconnect the MCP server if tools are missing. The hosted endpoint needs no local Python installation. +Open **Customize → Plugins → Kling → Configure**, paste the key string into **Ace Data Cloud API token**, and click **Save**. Cursor uses it as `ACEDATACLOUD_API_TOKEN`; the plugin adds `Bearer `. Reconnect the MCP server if tools are missing. The hosted endpoint needs no local Python installation. ```json { diff --git a/third_party/kling/readme/README_zh_Hans.md b/third_party/kling/readme/README_zh_Hans.md index 400c4e242..083893ce5 100644 --- a/third_party/kling/readme/README_zh_Hans.md +++ b/third_party/kling/readme/README_zh_Hans.md @@ -6,7 +6,7 @@ Generate Kling videos and retrieve the finished clip. 插件复用 [Ace Data Clo ## 1. 搜索安装 -在 Cursor 3.13 或更新版本打开 **Cursor Settings → Plugins**,搜索 **Kling**,确认作者 **Ace Data Cloud Dev** 和服务图标后点击 **Install**。也可在聊天中输入 `/add-plugin kling`。若官方条目尚未出现,可在 `~/.cursor/plugins/local/kling/` 本地审查;本地安装不代表 Marketplace 已上架。 +在 Cursor 3.24 打开 **Customize → Browse Marketplace**,搜索 **Kling**,确认作者 **Ace Data Cloud Dev** 和服务图标后点击 **Add**。较早版本可能在 Settings 中提供 Plugins 入口。也可在聊天中输入 `/add-plugin kling`。若官方条目尚未出现,可在 `~/.cursor/plugins/local/kling/` 本地审查;本地安装不代表 Marketplace 已上架。 ## 2. 获取服务 API Key @@ -18,7 +18,7 @@ Generate Kling videos and retrieve the finished clip. 插件复用 [Ace Data Clo ## 3. 配置插件 -在 **Dashboard → Plugins → Configure** 选择 **Kling**,将 Key 原文填入 `ACEDATACLOUD_API_TOKEN`。插件会自行添加 `Bearer `,连接 `https://kling.mcp.acedata.cloud/mcp`;无需安装本地 Python 服务。工具未出现时重新连接 MCP。 +打开 **Customize → Plugins → Kling → Configure**,将 Key 原文填入 **Ace Data Cloud API token** 并点击 **Save**。Cursor 将其用于 `ACEDATACLOUD_API_TOKEN`;插件会自行添加 `Bearer `,连接 `https://kling.mcp.acedata.cloud/mcp`;无需安装本地 Python 服务。工具未出现时重新连接 MCP。 ## 4. 首次调用 diff --git a/third_party/kling/skills/kling/SKILL.md b/third_party/kling/skills/kling/SKILL.md index 5db87ed61..347d0f820 100644 --- a/third_party/kling/skills/kling/SKILL.md +++ b/third_party/kling/skills/kling/SKILL.md @@ -11,4 +11,4 @@ This skill adapts the [existing Ace Data Cloud skill](https://github.com/AceData 2. Submit with `kling_generate_video` once. Save the returned `task_id` and use `kling_get_task` with that same ID until terminal. Pending is not a completed video; open the returned result URL on success. Never regenerate merely to poll. 3. Return the result, task ID if present, and any service error. Keep the API token out of chat and files. -Configure `ACEDATACLOUD_API_TOKEN` under **Dashboard → Plugins → Configure**. See the [first-run guide](../../README.md). +Configure `ACEDATACLOUD_API_TOKEN` in **Customize → Plugins → Kling → Configure**. See the [first-run guide](../../README.md). From 7727a492ca991b3ba97cc39fe9d4f5347ab3091c Mon Sep 17 00:00:00 2001 From: Ace Data Cloud Dev Date: Mon, 12 Oct 2026 05:31:53 +0000 Subject: [PATCH 4/4] docs: tag shared Cursor README activation links --- third_party/kling/README.md | 6 +++--- third_party/kling/readme/README_zh_Hans.md | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/third_party/kling/README.md b/third_party/kling/README.md index b078ecf1f..efdfd54f1 100644 --- a/third_party/kling/README.md +++ b/third_party/kling/README.md @@ -2,7 +2,7 @@ Generate Kling videos and retrieve the finished clip. This standalone plugin reuses the [Ace Data Cloud kling MCP](https://github.com/AceDataCloud/MCPs/tree/main/kling) and includes a focused Agent skill. Available tools and limits come from the live MCP schema. -[简体中文教程](readme/README_zh_Hans.md) · [Copyable first-run prompt](examples/first-run.md) · [Current pricing](https://platform.acedata.cloud/models) +[简体中文教程](readme/README_zh_Hans.md) · [Copyable first-run prompt](examples/first-run.md) · [Current pricing](https://platform.acedata.cloud/models?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=kling_cursor_shared_readme_pricing_en) ## 1. Search and install @@ -10,9 +10,9 @@ In Cursor 3.24, open **Customize → Browse Marketplace**, search for **Kling**, ## 2. Get a service API key -1. Sign in at [Ace Data Cloud Applications](https://platform.acedata.cloud/console/applications). +1. Sign in at [Ace Data Cloud Applications](https://platform.acedata.cloud/console/applications?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=kling_cursor_shared_readme_api_key_en). 2. Open **General application** or a service-specific application. Copy an existing API key, or use **Manage Keys → Create** for a separate Cursor key. -3. Confirm Kling access, [current price](https://platform.acedata.cloud/models), and balance. If **Allowed APIs** restrictions are enabled, include /kling/videos, /kling/tasks. +3. Confirm Kling access, [current price](https://platform.acedata.cloud/models?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=kling_cursor_shared_readme_pricing_en), and balance. If **Allowed APIs** restrictions are enabled, include /kling/videos, /kling/tasks. Use a service API key, not a platform management token. Do not put it in chat or source files. diff --git a/third_party/kling/readme/README_zh_Hans.md b/third_party/kling/readme/README_zh_Hans.md index 083893ce5..fe9126712 100644 --- a/third_party/kling/readme/README_zh_Hans.md +++ b/third_party/kling/readme/README_zh_Hans.md @@ -2,7 +2,7 @@ Generate Kling videos and retrieve the finished clip. 插件复用 [Ace Data Cloud kling MCP](https://github.com/AceDataCloud/MCPs/tree/main/kling),并提供专用 Agent skill。实际工具参数和限制以在线 MCP schema 为准。 -[English guide](../README.md) · [可复制的首跑提示词](../examples/first-run.md) · [当前价格](https://platform.acedata.cloud/models) +[English guide](../README.md) · [可复制的首跑提示词](../examples/first-run.md) · [当前价格](https://platform.acedata.cloud/models?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=kling_cursor_shared_readme_pricing_zh_hans) ## 1. 搜索安装 @@ -10,9 +10,9 @@ Generate Kling videos and retrieve the finished clip. 插件复用 [Ace Data Clo ## 2. 获取服务 API Key -1. 登录 [Ace Data Cloud 应用管理](https://platform.acedata.cloud/console/applications)。 +1. 登录 [Ace Data Cloud 应用管理](https://platform.acedata.cloud/console/applications?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=kling_cursor_shared_readme_api_key_zh_hans)。 2. 打开 **General application** 或服务专用应用,复制已有 Key;也可通过 **Manage Keys → Create** 新建 Cursor 专用 Key。 -3. 确认 Kling 权限、[当前价格](https://platform.acedata.cloud/models)和余额。若启用了 **Allowed APIs**,允许 /kling/videos, /kling/tasks。 +3. 确认 Kling 权限、[当前价格](https://platform.acedata.cloud/models?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=kling_cursor_shared_readme_pricing_zh_hans)和余额。若启用了 **Allowed APIs**,允许 /kling/videos, /kling/tasks。 使用服务 API Key,不要用平台管理 token,也不要放在聊天或仓库文件中。