跳转到内容
ModelflareModelflareModelflare
打开 Castaly控制台

生成图片与视频

Modelflare Media Skill

安装一个 Agent Skill，让 Claude Code、Codex 或任何读取 SKILL.md 的 Agent 会选择 Modelflare 图片/视频模型、核算价格、发起请求并保存结果。

Modelflare Media Skill 是一个可安装的 Agent Skill：一个包含 SKILL.md、自动生成的模型参考表和一个辅助脚本的目录。放进 Agent 的 skills 目录后，Claude Code、Codex 或任何会读取 SKILL.md 的 Agent 就知道如何选择 Modelflare 的图片或视频模型、核算价格、发出正确的请求、等待视频完成并保存结果。

这个包每隔几分钟就会从实时模型目录重新生成，因此里面的模型清单和价格不会过期。文本模型刻意不包含在内：你的 Agent 本来就有一个。辅助脚本只需要 Node.js 18 及以上（Claude Code 和 Codex 本来就依赖它），在 macOS、Windows、Linux 上行为一致。

1. 安装

Section titled “1. 安装”

你不需要知道 Agent 把 Skill 放在哪，Agent 自己知道。把下面这段话发给它，所有 Agent 用同一句：

Text
请安装这个 Skill：https://modelflare.dev/skills/modelflare-media/modelflare-media.zip（或使用我附上的 zip），然后读取其中的 SKILL.md。如果你不支持 Skill 机制，就解压到任意位置并按 SKILL.md 操作。我的 Key 在环境变量 MODELFLARE_API_KEY 里。

如果 Agent 不能下载文件，就先下载 zip，随消息一起发给它。支持 Skill 的 Agent（Claude Code、Codex 等）会装到自己的 skills 位置；没有 Skill 机制的 Agent 也能从解压位置直接读取 SKILL.md。

手动安装（可选）

Section titled “手动安装（可选）”

只在你想自己放置文件时需要，比如共用机器或 CI。

终端窗口bash
curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

也可以直接阅读 SKILL.md，看看 Agent 会照着做什么。

2. 给 Agent 一把 Key

Section titled “2. 给 Agent 一把 Key”

在控制台创建 API Key，并在 Agent 运行的环境里设置。macOS 与 Linux 写进 shell 配置文件可长期保留；Windows 第二行为永久生效。

终端窗口bash
export MODELFLARE_API_KEY="sk-..."

如果你不熟悉环境变量配置，也可以在私密会话里把自己的 Key 发给自己信任的 Agent，让它代为配置。API Key 等同密码：先确认 Agent 会写入哪里，只发给你明确控制且可信的 Agent；不要发到公共或共享聊天、工单、Issue、仓库，也不要让它写入源代码、提示词、日志或 shell 历史。要求 Agent 配置后不要回显 Key、保存副本或提交；如果怀疑泄露，请立即在控制台撤销并重新创建。

Skill 不会把 Key 写进文件或提示词，也不会打印出来。通过 Castaly 注册的账号已经有一把名为 Castaly 的 Key，会在所有已解锁分组间自动路由；其他带图片/视频分组的 Key 同样可用。

3. 直接提需求

Section titled “3. 直接提需求”

像平时一样和 Agent 对话：

  • “用 gpt-image-2 生成一张 16:9 的海岸天文台黄昏海报。”
  • “把这张首帧用 Seedance 做成 5 秒 1080p 视频。”
  • “每秒低于 0.10 美元且支持图生视频的视频模型有哪些？”

Agent 会读 SKILL.md，先请求 https://modelflare.dev/api/pricing 看这把 Key 能用哪些模型、各自多少钱，再打开该模型在文档站里的独立页面，拿到完整请求体、参数表和限制，然后用它自己的 HTTP 客户端发请求。每次调用都带 X-Modelflare-Skill: modelflare-media/1.0 请求头，用量日志里能看到哪些请求来自这个 Skill。

4. 从 Castaly 工作台出发

Section titled “4. 从 Castaly 工作台出发”

Castaly 工作台里每一次生成都有“在你自己的 Agent 里复现”面板，提供安装消息、zip 和任务简报。安装消息发一次，之后粘贴简报，Agent 就会用你自己的 Key 以同样的模型和参数复现。

Skill 不会做的事

Section titled “Skill 不会做的事”
  • 不规定你的 Agent 怎么做事。重试、批量、结果怎么汇报，都是你和你的 Agent 之间的事，Skill 只负责说清接口。
  • 自己不带模型清单。目录和每个模型的请求契约都是实时读取的，今天上线的模型今天就能用。
  • 不会把文件上传到任何存储：本地参考图以 data URL 形式内嵌在请求里，所以请控制在几 MB 以内。
  • 不能解锁模型分组。若接口返回 model_unavailable，说明这个账号用不了该模型。

包结构

Section titled “包结构”
Text
modelflare-media/
  SKILL.md   认证方式、实时目录在哪、每个模型的请求契约去文档站哪一页看、错误码含义

包里不含模型数据，所以不会过期；只有 Skill 本身升级时才需要重装。