Modelflare Media Skill

Modelflare Media Skill là một kỹ năng tác nhân có thể cài đặt: một thư mục có SKILL.md, một tham chiếu mô hình được tạo và một tập lệnh trợ giúp. Khi nó nằm trong thư mục kỹ năng của đại lý của bạn, Claude Code, Codex hoặc bất kỳ đại lý nào đọc SKILL.md sẽ biết cách chọn mô hình hình ảnh hoặc video Modelflare, báo giá, gửi yêu cầu phù hợp, chờ video và lưu kết quả.

Cứ sau vài phút, gói này được tạo từ danh mục mẫu trực tiếp, vì vậy danh sách mẫu và giá trong đó không bao giờ cũ. Các mô hình văn bản cố tình nằm ngoài phạm vi: đại lý của bạn đã có một mô hình văn bản. Tập lệnh trợ giúp chỉ cần Node.js 18 trở lên mà Claude Code và Codex đã yêu cầu và hoạt động tương tự trên macOS, Windows và Linux.

1. Cài đặt

Bạn không cần biết người đại diện của bạn giữ kỹ năng ở đâu; đại lý làm. Gửi cho nó tin nhắn này, cùng một tin nhắn cho mọi đại lý:

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.

Nếu tác nhân không thể tải xuống tệp, hãy tự tải xuống zip và đính kèm vào tin nhắn. Các đại lý hỗ trợ kỹ năng (Claude Code, Codex và những người khác) cài đặt nó ở vị trí kỹ năng của riêng họ; một tác nhân không có cơ chế kỹ năng vẫn có thể đọc SKILL.md từ bất cứ nơi nào nó trích xuất gói.

Cài đặt thủ công (tùy chọn)

Chỉ cần thiết nếu bạn muốn tự mình đặt các tệp, chẳng hạn như trên máy dùng chung hoặc trong CI.

curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

Cả hai đều cài đặt vào ~/.claude/skills/modelflare-media (trên Windows là %USERPROFILE%\.claude\skills), mà Claude Code đọc là kỹ năng cấp độ người dùng; một bản sao cấp dự án sẽ được đưa vào .claude/skills/ bên trong kho lưu trữ. Đối với một tác nhân khác, trước tiên hãy đặt SKILL_DIR vào thư mục kỹ năng của nó (xem tài liệu của tác nhân đó để biết đường dẫn chính xác).

SKILL_DIR=~/.codex/skills curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

$env:SKILL_DIR = "$HOME\.codex\skills"; irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

Bạn cũng có thể đọc trực tiếp SKILL.md để xem đại lý sẽ tuân theo những gì.

2. Đưa chìa khóa cho đại lý của bạn

Tạo khóa API trong console và đặt nó trong môi trường mà tác nhân của bạn chạy trong đó. Trên macOS và Linux, hãy thêm bản xuất vào cấu hình shell của bạn để giữ nó; trên Windows dòng thứ hai làm cho nó liên tục.

macOS hoặc Linux
Windows PowerShell

export MODELFLARE_API_KEY="sk-..."

$env:MODELFLARE_API_KEY = "sk-..."
setx MODELFLARE_API_KEY "sk-..."

Nếu không thoải mái khi tự mình thiết lập các biến môi trường, bạn có thể gửi khóa đến đại lý đáng tin cậy của riêng mình trong một phiên riêng tư và yêu cầu họ định cấu hình môi trường cho bạn. Coi khóa như mật khẩu: xác nhận nhân viên sẽ viết gì và ở đâu, không bao giờ gửi nó đến một dịch vụ không đáng tin cậy hoặc cuộc trò chuyện, vấn đề, kho lưu trữ hoặc phiếu yêu cầu công khai/chia sẻ. Yêu cầu tác nhân không lặp lại khóa, lưu một bản sao, đặt nó vào mã nguồn, lời nhắc, nhật ký hoặc lịch sử trình bao hoặc cam kết. Thu hồi khóa và tạo một khóa mới ngay lập tức nếu bạn cho rằng nó có thể đã bị lộ.

Kỹ năng này không bao giờ ghi khóa vào tệp hoặc lời nhắc và không bao giờ in nó. Các tài khoản được tạo thông qua Castaly đã có khóa có tên Castaly định tuyến trên mọi nhóm đã được mở khóa; bất kỳ phím nào khác có nhóm hình ảnh hoặc video cũng hoạt động.

3. Yêu cầu phương tiện truyền thông

Nói chuyện với đại lý của bạn như thường lệ:

“Tạo áp phích 16:9 của đài quan sát ven biển vào lúc hoàng hôn với gpt-image-2.”
“Biến khung hình bắt đầu này thành video 1080p dài 5 giây với Seedance.”
“Mô hình video nào có giá dưới 0,10 USD mỗi giây có thể thực hiện chuyển đổi hình ảnh thành video?”

Tác nhân đọc SKILL.md, tìm nạp danh mục trực tiếp từ https://modelflare.dev/api/pricing để xem khóa có thể sử dụng mô hình nào và giá của chúng, sau đó mở trang riêng của mô hình đó trên trang tài liệu để biết nội dung yêu cầu chính xác, bảng tham số và giới hạn, đồng thời gọi API bằng ứng dụng khách HTTP riêng. Mọi cuộc gọi đều mang tiêu đề X-Modelflare-Skill: modelflare-media/1.0, do đó, nhật ký sử dụng hiển thị những yêu cầu nào đến từ kỹ năng.

4. Từ bàn làm việc của Castaly

Mỗi thế hệ trong Castaly Workbench đều có bảng “Tái tạo cái này trong tác nhân của riêng bạn” với thông báo cài đặt, zip và tóm tắt nhiệm vụ. Gửi thông báo cài đặt một lần, sau đó dán bản tóm tắt và tác nhân sẽ tái tạo mô hình và thông số tương tự dựa trên khóa của riêng bạn.

Kỹ năng không làm được gì

Nó không cho đại lý của bạn biết cách làm việc. Việc thử lại, phân đợt và nội dung cần báo cáo lại là việc giữa bạn và đại lý của bạn; kỹ năng này chỉ ghi lại API.
Nó không có danh sách model riêng. Danh mục và mọi hợp đồng yêu cầu đều được đọc trực tiếp, vì vậy mô hình được xuất bản hôm nay vẫn có thể sử dụng được ngay hôm nay.
Nó không tải tệp lên bất kỳ bộ lưu trữ nào: hình ảnh tham chiếu cục bộ được nhúng trong yêu cầu dưới dạng URL dữ liệu, vì vậy hãy giữ chúng ở kích thước nhỏ (vài MB).
Nó không thể mở khóa các nhóm mô hình. Nếu API trả lời model_unavailable, mô hình đó không có sẵn cho tài khoản này.

Bố cục gói hàng

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

Gói không chứa dữ liệu mô hình nên không bị cũ; chỉ cài đặt lại để nhận phiên bản kỹ năng mới.