主题
如何使用 API
只要把下面的提示词发给 Agent，它就会主动向你要模型文档链接和 Key，之后自己按 ClawPower 文档调用图像 / 视频模型，不需要你再翻模型细节。
前提
本页默认你已经具备以下条件：
- 已创建 ClawPower API Key。
分组必须选对
在使用前把 Key 的分组选为「图像视频精选」。
如果没有 Key，下方是常用入口，按需跳转即可：
API 端点
所有 ClawPower 模型的接口都发往 https://api.clawpowerai.com，不同模型用不同路径区分；具体路径写在下面示例里 Agent 要去读的模型文档里。
示例 1：教会 Agent 生成图片
复制下面的提示词，原文发送给你的 Agent，不需要做任何修改：
text
请帮我接入 ClawPower 的图片生成模型，并按下面的流程工作：
1. 先向我要两项信息，收齐之前不要开始生成：
- 我要使用的图片模型的 ClawPower API 文档完整链接（链接内容里已经写了模型名、接口、参数，不用再额外告诉我模型叫什么）
- 我的 ClawPower API Key（分组必须为「图像视频精选」）
2. 打开我提供的 API 文档链接，阅读并掌握该模型的接口地址、认证方式、请求参数和响应格式，一切以文档为准；如需使用本地图片，先按文档调用 ClawPower 的上传图片接口换取可访问的 URL。
3. 信息收齐后，向我要「想要生成的画面描述」，调用接口完成生图并把图片发给我。整个过程一气呵成，不要中途停下来问我「要不要继续」「是否要等」之类的话——我只需要在最后收到图片（或一条失败原因）。
4. 把第 1、2 步拿到的文档链接与 Key 写入你的全局记忆（用户级配置文件，而不是只属于当前项目的记忆），并将该模型设为默认图片模型。之后只要我对你说「用 ClawPower 生成图片」，就跳过第 1、2 步：从全局记忆里读取所有图片模型的文档链接逐个识别，只有一个就直接向我要画面描述并生成；多个就先告诉我「默认模型是 XX，本机还有 XX 和 XX，请选择使用哪个模型」，等我确认后再继续。整个生图过程同样不要中途向我提问。
5. 如果我说「再接入一个 ClawPower 图片模型，文档链接：YY」，把新模型追加到全局记忆，默认模型保持不变；如果我说「把默认图片模型改成 YY」，就打开新链接识别模型名并更新默认。两种情况都不需要重新问我要 Key。
现在开始第 1 步，先向我要这两项信息。发送后 Agent 会先向你要两样东西：
- 文档链接：下面表格里只展示了一个示例，点右侧「复制」按钮拿到完整 URL 发给它；想用其他模型，从左侧菜单「图像模型」里找对应文档地址复制即可。
- Key：把「图像视频精选」分组下的 Key 发给它。
| 文档地址（点右侧按钮一键复制完整链接） |
|---|
两项都给它之后，它会向你要画面描述，然后开始生图。
示例 2：教会 Agent 生成视频
复制下面的提示词，原文发送给你的 Agent，不需要做任何修改：
text
请帮我接入 ClawPower 的视频生成模型，并按下面的流程工作：
1. 先向我要两项信息，收齐之前不要开始生成：
- 我要使用的视频模型的 ClawPower API 文档完整链接（链接内容里已经写了模型名、接口、参数，不用再额外告诉我模型叫什么）
- 我的 ClawPower API Key（分组必须为「图像视频精选」）
2. 打开我提供的 API 文档链接，阅读并掌握该模型的接口地址、认证方式、请求参数和响应格式，一切以文档为准；视频模型通常需要你额外阅读 ClawPower 的「查询视频任务」文档（https://docs.clawpowerai.com/api/tasks/query-video-task ），因为视频生成是异步的，提交任务后必须通过该接口轮询获取视频 URL 再下载。
3. 信息收齐后，向我要「想要生成的视频描述」，提交生成任务 → 用「查询视频任务」接口按文档建议的轮询节奏（间隔与最大次数以文档为准）持续查询 → 直到视频可下载 → 拿到视频文件 URL 后下载 → 把视频发给我。整个过程一气呵成：只在提交成功后简短告知我一次「已提交，任务 ID：xxx，正在生成」（只是为了让我知道开始干了，不是请求我确认），然后就不要再问我任何话、不要把每一次轮询的 status 念给我听；轮询达到最大次数仍不成功时再把失败信息与原因一次性告诉我。视频模型同理，我只需要在最后收到视频（或一条失败原因）。
4. 把第 1、2 步拿到的文档链接与 Key 写入你的全局记忆（用户级配置文件，而不是只属于当前项目的记忆），并将该模型设为默认视频模型。之后只要我对你说「用 ClawPower 生成视频」，就跳过第 1、2 步：从全局记忆里读取所有视频模型的文档链接逐个识别，只有一个就直接向我要视频描述并按上面第 3 步的流程（提交任务 → 轮询 → 下载 → 发我）跑完全程，期间不要向我提问；多个就先告诉我「默认模型是 XX，本机还有 XX 和 XX，请选择使用哪个模型」，等我确认后再继续此流程。
5. 如果我说「再接入一个 ClawPower 视频模型，文档链接：YY」，把新模型追加到全局记忆，默认模型保持不变；如果我说「把默认视频模型改成 YY」，就打开新链接识别模型名并更新默认。两种情况都不需要重新问我要 Key。
现在开始第 1 步，先向我要这两项信息。发送后 Agent 会先向你要两样东西：
- 文档链接：下面表格里只展示了一个示例，点右侧「复制」按钮拿到完整 URL 发给它；想用其他模型，从左侧菜单「视频模型」里找对应文档地址复制即可。
- Key：把「图像视频精选」分组下的 Key 发给它。
| 文档地址（点右侧按钮一键复制完整链接） |
|---|
查询视频任务接口不用你单独发
视频是异步生成的——但你不需要为它单独再复制一个链接发过去。上面那段视频提示词的第 2 步里，已经包含了 ClawPower 的「查询视频任务」接口地址（https://docs.clawpowerai.com/api/tasks/query-video-task）。Agent 收到后会自己打开它学习查询节奏，照着调用即可。
两项都给它之后，它会向你要视频描述，然后开始生成（提交任务 → 轮询 → 下载视频 → 发回）。
一次性配置 + 全自动执行
发送完上面任一段提示词后，正常的运行流程是这样的：
- Agent 向你要文档链接和Key；
- 你各发一份给它；
- Agent 自动记住配置并问你画面描述 / 视频描述；
- 你发一句描述（如「夕阳下的雪山，8K，电影感」）；
- Agent 自动完成生成 + 异步轮询 + 下载 + 发回给你。
整个过程你不需要再发任何消息，Agent 也不会在轮询期间反复问你「要不要继续」「是否要等」——它会按文档节奏一直查询到成功（或在文档建议的最大次数内失败），只在最后把结果或失败原因一次性发给你。这就是「发一次配置教程，之后全程不用再管」的目标。
下次使用时如何唤醒
第一次配置完成后，Agent 已经把配置写入了它的全局记忆。之后再想生图 / 生视频，在任何项目里直接对它说：
- 用 ClawPower 生成图片 —— 自动识别全局记忆里的图片模型文档链接，只有一个就直接生图；多个就先汇报「默认模型是 XX，本机还有 XX 和 XX，请选择使用哪个模型」；
- 用 ClawPower 生成视频 —— 视频同理，唤醒后会从记忆里读出视频模型文档逐个识别，必要时主动查「查询视频任务」接口取视频 URL 并下载。
唤醒词必须带「ClawPower」前缀。如果只说「生成图片」，Agent 可能会调用它自己的内置模型而不是 ClawPower。
不需要重新发送上面的提示词，也不需要再发一次 Key。
有多个模型时怎么选
唤醒时 Agent 会先打开全局记忆里记的全部图片 / 视频模型文档链接逐一识别：只有一个就直接用；多个就先汇报默认那个 + 其他可选列表，等你确认后再继续。
想往记忆里再添加一个模型，复制下面这条发给 Agent：
text
再接入一个 ClawPower 图片模型，文档链接：https://docs.clawpowerai.com/api/images/nano-banana-2想接入其他模型，把这条消息里的 URL 换成在左侧菜单找到的对应文档地址即可——不用一行一行复制本页面列出的每一个模型。视频模型同理，把「图片」换成「视频」。Agent 收到后会自己打开链接识别模型名再加入列表，默认模型不变。
把某个模型设为默认，对 Agent 说「把默认图片模型改成 Nano Banana 2」即可。
让一台电脑的所有项目共用
上面两个提示词是纯文本指令，保存在哪里，就决定了它生效的范围：
- 只贴在对话里 —— 只对当前这个会话有效；
- 存进 Agent 的全局记忆 / 全局配置文件 —— 同一台电脑上的所有项目都生效，只需教一次。
常用 Agent 的全局配置文件位置：
| Agent | 全局配置文件 |
|---|---|
| Claude Code | ~/.claude/CLAUDE.md |
| Codex | ~/.codex/AGENTS.md |
| Gemini CLI | ~/.gemini/GEMINI.md |
两种做法任选其一：
- 让 Agent 自己存：示例提示词第 4 步已经要求它写入全局记忆，第一次发送时它就会自动完成，其他项目无需再做任何事；
- 手动保存：把示例提示词原文追加到上表中你所用 Agent 对应文件的末尾，再把模型文档地址与 Key 一并写进去，保存即可。
关于 Key 的存放
写入全局配置后，Key 会以明文保存在本机文件中。请确认这台电脑只由你本人使用；如需更换 Key，重新创建令牌并更新配置文件即可。