跳到內容
開放式卡斯塔利控制台

圖片和視頻

Modelflare Media Skill

安裝一項代理技能,以便 Claude Code、Codex 或任何支援 SKILL.md 的代理可以選擇 Modelflare 圖像或視訊模型、為通話定價、提交並保存結果。

Modelflare Media Skill 是一項可安裝的代理技能:一個帶有 SKILL.md 的資料夾、生成的模型參考和一個幫助程式腳本。一旦進入您的代理技能目錄,Claude Code、Codex 或任何讀取 SKILL.md 的代理都知道如何選擇 Modelflare 圖像或視訊模型、報價、發送正確的請求、等待視訊並保存結果。

該套件每隔幾分鐘從即時模型目錄生成一次,因此其中的模型清單和價格永遠不會過時。文字模型故意超出範圍:您的代理程式已經有了一個。幫助程式腳本只需要 Node.js 18 或更高版本,Claude Code 和 Codex 已經需要,並且在 macOS、Windows 和 Linux 上的行為相同。

你不需要知道你的代理人在哪裡保存技能;代理人確實如此。向其發送此訊息,每個代理都會發送相同的訊息:

Text
Install this skill: https://modelflare.dev/skills/modelflare-media/modelflare-media.zip (or use the attached zip), then read its SKILL.md. If you do not support skills, extract it anywhere and follow SKILL.md. My key is in the environment variable MODELFLARE_API_KEY.

如果代理無法下載文件,請自行下載 zip 並將其附加到郵件中。支援技能的代理程式(Claude Code、Codex 等)將其安裝在自己的技能位置;沒有技能機制的代理程式仍然可以從提取包的任何位置讀取SKILL.md。

只有當您希望自己放置檔案時才需要,例如在共用電腦上或 CI 中。

終端機視窗bash
curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

您也可以直接閱讀SKILL.md來查看代理程式將遵循什麼。

在 控制台 中建立 API 金鑰,並在代理程式運行的環境中設定它。在 macOS 和 Linux 上,將匯出新增至 shell 設定檔中以保留它;在 Windows 上,第二行使其持久化。

終端機視窗bash
export MODELFLARE_API_KEY="sk-..."

如果您不習慣自行設定環境變量,您可以在私人會話中將金鑰傳送給您自己的可信任代理,並要求它為您配置環境。將金鑰視為密碼:確認代理將寫入的內容和位置,切勿將其傳送至不受信任的服務或公用/共用聊天、問題、儲存庫或票證。要求代理不要重複金鑰,保存副本,將其放入原始碼、提示、日誌或 shell 歷史記錄中,或提交。如果您認為密鑰可能已洩露,請立即撤銷密鑰並建立新密鑰。

此技能從不將金鑰寫入檔案或提示中,也從不列印它。透過 Castaly 建立的帳戶已經有一個名為 Castaly 的密鑰,該密鑰可以在每個未鎖定的群組之間路由;任何其他帶有圖像或視訊群組的按鍵也適用。

像往常一樣與您的代理人交談:

  • “使用 gpt-image-2. 產生黃昏時海岸天文台的 16:9 海報”
  • “使用 Seedance 將此起始幀轉換為 5 秒 1080p 視訊。”
  • “哪些每秒0.10美元以下的視頻模型可以進行圖像到視頻?”

代理程式讀取 SKILL.md,從 https://modelflare.dev/api/pricing 取得即時目錄以查看金鑰可以使用哪些模型以及它們的成本,然後在 文件網站 上開啟該模型自己的頁面以取得確切的請求正文、參數表和限制,並使用自己的 HTTP 用戶端呼叫 API。每個呼叫都帶有標頭 X-Modelflare-Skill: modelflare-media/1.0,因此 使用日誌 顯示哪些請求來自該技能。

Cataly 工作台 中的每一代都有一個「在您自己的代理程式中複製此內容」面板,其中包含安裝訊息、zip 和任務簡介。發送一次安裝訊息,然後貼上摘要,代理將根據您自己的金鑰重現相同的模型和參數。

  • 它不會告訴您的代理商如何運作。重試、批次和報告內容由您和您的代理商決定;此技能僅記錄 API。
  • 它沒有自己的型號清單。目錄和每個請求合約都是即時讀取的,因此今天發布的模型今天就可以使用。
  • 它不會將文件上傳到任何儲存空間:本機參考圖像會作為資料 URL 嵌入在請求中,因此請保持它們較小(幾 MB)。
  • 無法解鎖模型組。如果 API 回答 model_unavailable,則該模型對該帳戶不可用。
Text
modelflare-media/
SKILL.md authentication, where the live catalog is, how to find each model's
request contract on the docs site, and what the error codes mean

該包不攜帶模型數據,因此不會過時;重新安裝只是為了獲取新的技能版本。