如何通过 AKOOL MCP 在 Claude Code 中生成 AI 视频

Updated:

October 19, 2026

了解 Claude Code 与 AKOOL MCP 的图生视频工作流，涵盖连接、模型发现、生成提示词、任务状态查询和结果保存。

Claude 可以通过 AKOOL MCP 等已连接服务请求创建视频。在这一工作流中，Claude Code 提交图生视频任务、查询状态并获取结果。AKOOL 负责生成视频，Claude 则提供聊天界面，让你描述、查看和管理任务。

如果你想通过 Claude 生成 AI 视频，需要明确：Claude 本身并非渲染模型。AKOOL AI 视频创作平台通过 Model Context Protocol 连接提供视频生成工具。

要点速览

连接：使用 AKOOL Client ID 和 Client Secret，将 AKOOL MCP 服务器添加到 Claude Code。
准备：提交生成任务前，确保工作流能够访问已获准使用的源图像。
生成：先发现工具和模型，再提交一个video_image2video_create 任务，并保存任务标识符。
保存：使用 video_image2video_results 轮询已有任务，然后保存生成的视频，不要再次提交请求。

Claude 能生成视频吗？

通过 MCP 连接渲染服务后，Claude 可以发起视频生成。在此工作流中，Claude Code 理解你的请求，Model Context Protocol 将 Claude 与 AKOOL 工具连接起来，AKOOL 负责实际的图生视频生成。之后，Claude 查询异步任务并返回完成的结果。

Layer	Role	What it does
Claude Code	Client and conversational interface	Understands your instruction and invokes tools
Model Context Protocol	Connection layer	Exposes AKOOL functions as tools Claude can discover and call
AKOOL	Generation service	Runs the image-to-video job and returns its result

AKOOL 的官方 MCP 文档目前列出了 account_models、account_credit、video_image2video_create 和 video_image2video_results 等工具。如需了解更多集成方式，请参阅用于 AI 视频生成的 MCP 服务器。

使用 Claude Code 生成视频需要哪些准备？

你需要 Claude Code、具有有效 API 凭据的 AKOOL 账号、足以支持所选生成任务的 AKOOL 积分，以及连接的工作流能够访问且已获准使用的源图像。Claude 的访问权限与 AKOOL 视频生成费用分开计算。

准备以下四项：

Claude Code。本指南使用 Claude Code，而非 Claude Desktop。
AKOOL Client ID 和 Client Secret。AKOOL 使用 x-client-id 和 x-client-secret 请求头进行 MCP 身份验证。
生成积分。使用 account_credit 查看 AKOOL 积分余额。
已获准使用的源图像。使用你拥有或获准转换的图像。

有关准备合适源素材的方法，请参阅 AKOOL 的图生视频工作流。

清晰的产品照片适合首次测试，因为判断标准很明确：当指定的镜头运动发生时，产品是否仍能被清楚识别？

如何连接 AKOOL MCP 服务器？

使用 AKOOL 文档中的 Claude Code 连接方式。服务器端点为 https://openapi.akool.com/mcp/v1，通过 x-client-id 和 x-client-secret 请求头验证身份。不要在提示词、截图、代码仓库或公开文档中暴露这两项凭据。

如有需要，先安装 Claude Code：

npm install -g @anthropic-ai/claude-code

然后添加 AKOOL MCP 服务器。以下是 AKOOL 文档命令中避免直接写入凭据的版本：

claude mcp add akool-mcp https://openapi.akool.com/mcp/v1 \
  --header "x-client-id: $AKOOL_CLIENT_ID" \
  --header "x-client-secret: $AKOOL_CLIENT_SECRET"

AKOOL 文档建议将密钥保存在环境变量中，避免提交到版本控制系统。

验证连接：

claude mcp list

你应该能看到 AKOOL 服务器条目，例如：

akool-mcp   http   https://openapi.akool.com/mcp/v1

有关最新设置命令和配置细节，请使用官方AKOOL MCP 设置说明。不要将凭据复制到截图中。

图生视频 MCP 任务如何运行？

最稳妥的工作流会将发现、提交、状态查询和结果获取分开处理。新的视频生成可能消耗积分。查询已有任务状态时，应复用其任务标识符，而非再次提交生成请求。

1. 发现可用工具和模型

向 Claude 提问：

列出本次会话中可用的 AKOOL 工具。找出图生视频创建工具和结果工具，展示所需输入，但不要启动生成任务。

需要找到 video_image2video_create 和 video_image2video_results。AKOOL 还提供 account_models，使智能体能够查看已连接账号可用的模型。

2. 准备图像

使用内容稳定、权利已确认且主体清晰的源图像。

示例：

/product-assets/blue-bottle-approved.png

只有 Claude Code 和相关工具确实能够访问本地路径时，才应依赖该路径。

3. 提交前先规划

向 Claude 提问：

以我已批准使用的产品图为源图像，规划一个缓慢推进镜头、产品保持静止的短片。提交前展示拟用模型、支持的设置以及任何可用的费用信息。

这一步只做规划，不应启动付费生成。

4. 提交一个任务

确认方案后：

将商定的图生视频请求提交一次。使用轻柔的镜头运动，让产品保持静止，并返回任务标识符。

AKOOL 文档将 video_image2video_create 定义为创建工具。

立即保存返回的标识符：

Task ID: [SAVED_TASK_ID]

5. 轮询同一个任务

提问：

使用已保存的标识符查询现有任务。报告它处于排队、处理中、已完成还是失败状态。不要创建新任务。

AKOOL 说明，许多 MCP 工具是异步的，需要使用结果工具轮询完成状态。

6. 保存结果

完成后：

返回成片链接和保存位置，并将成片与源图像比较。在保留原始输出的前提下，为下一次尝试提出一项运动调整建议。

一个简单的任务生命周期如下：

account_models
      ↓
video_image2video_create
      ↓
[SAVED_TASK_ID]
      ↓
video_image2video_results
      ↓
queued → processing → complete
      ↓
[RESULT_URL]

应该使用哪些 Claude 视频提示词？

使用能明确表达任务状态的提示词。关键的安全区别在于：指令只是查看会话，还是创建新的付费生成任务。

Prompt	What it does	New generation?
1. Discovery	Inspects tools and required inputs	No
2. Planning	Reviews model/settings before submission	No
3. Generation	Submits the image-to-video task	Yes
4. Status	Checks the saved task	No
5. Save and revise	Retrieves output and proposes a revision	No, unless you approve another run

提示词 1：发现

列出本次会话中可用的 AKOOL 工具。找出图生视频创建工具和结果工具，展示所需输入，但不要启动生成任务。

提示词 2：规划

以我已批准使用的产品图为源图像，规划一个缓慢推进镜头、产品保持静止的短片。提交前展示拟用模型、支持的设置以及任何可用的费用信息。

提示词 3：生成

将商定的图生视频请求提交一次。使用轻柔的镜头运动，让产品保持静止，并返回任务标识符。

提示词 4：状态

使用已保存的标识符查询现有任务。报告它处于排队、处理中、已完成还是失败状态。不要创建新任务。

提示词 5：保存和修改

返回成片链接和保存位置，并将成片与源图像比较。在保留原始输出的前提下，为下一次尝试提出一项运动调整建议。

这些Claude 视频提示词有意将规划与执行分开。对于任何AI 视频自动化工作流，这都很有用，因为意外的二次提交可能额外消耗积分。

如何排查 AI 视频自动化问题？

重新提交任何内容前，先检查当前任务与连接状态。许多失败源于身份验证、文件访问或异步状态问题，并不意味着应该重新生成。

Symptom	First check	Next action
AKOOL tools are missing	`claude mcp list`	Recheck MCP setup and restart Claude Code
Authentication fails	Client ID and secret	Verify credentials in AKOOL dashboard
`401 Unauthorized`	MCP headers	Replace invalid credentials
Source image cannot be used	File accessibility	Move or upload the asset somewhere the workflow can access
Job stays queued	Saved task ID	Poll the same job later
Result says failed	Existing result response	Read the failure before changing inputs
No download available	Job status	Confirm task is actually complete
Download link expired	Stored output/state	Retrieve a fresh available result rather than blindly regenerate
Two jobs appear	Task history	Confirm whether generation was submitted twice