Lewati ke konten
ModelflareModelflareModelflare
Buka CastalyKonsol

Gambar dan video

Modelflare Media Skill

Instal satu keterampilan agen sehingga Claude Code, Codex, atau agen mana pun yang mengetahui SKILL.md dapat memilih gambar atau model video Modelflare, memberi harga pada panggilan, mengirimkannya, dan menyimpan hasilnya.

Modelflare Media Skill adalah keterampilan agen yang dapat diinstal: folder dengan SKILL.md, referensi model yang dihasilkan, dan satu skrip pembantu. Setelah berada di direktori keterampilan agen Anda, Claude Code, Codex, atau agen apa pun yang bertuliskan SKILL.md tahu cara memilih model gambar atau video Modelflare, mengutip harganya, mengirim permintaan yang tepat, menunggu video, dan menyimpan hasilnya.

Paket dihasilkan dari katalog model langsung setiap beberapa menit, sehingga daftar model dan harga di dalamnya tidak pernah basi. Model teks sengaja di luar cakupan: agen Anda sudah memilikinya. Skrip pembantu hanya memerlukan Node.js 18 atau lebih baru, yang sudah diperlukan oleh Claude Code dan Codex, dan berperilaku sama di macOS, Windows, dan Linux.

1. Instal

Section titled “1. Instal”

Anda tidak perlu tahu di mana agen Anda menyimpan keterampilan; agen melakukannya. Kirimkan pesan ini, pesan yang sama untuk setiap agen:

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.

Jika agen tidak dapat mengunduh file, unduh sendiri zipnya dan lampirkan ke pesan. Agen yang mendukung keterampilan (Claude Code, Codex, dan lainnya) memasangnya di lokasi keterampilan mereka sendiri; agen tanpa mekanisme keterampilan masih dapat membaca SKILL.md dari mana pun ia mengekstrak paket.

Instalasi manual (opsional)

Section titled “Instalasi manual (opsional)”

Hanya diperlukan jika Anda lebih suka menempatkan file sendiri, misalnya di mesin bersama atau di CI.

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

Anda juga dapat membaca SKILL.md secara langsung untuk melihat apa yang akan diikuti oleh agen.

2. Berikan kunci kepada agen Anda

Section titled “2. Berikan kunci kepada agen Anda”

Buat kunci API di konsol dan atur di lingkungan tempat agen Anda berjalan. Di macOS dan Linux, tambahkan ekspor ke profil shell Anda untuk menyimpannya; pada Windows, baris kedua membuatnya tetap ada.

Terminal windowbash
export MODELFLARE_API_KEY="sk-..."

Jika Anda merasa tidak nyaman mengatur sendiri variabel lingkungan, Anda dapat mengirimkan kunci ke agen tepercaya Anda dalam sesi pribadi dan memintanya untuk mengonfigurasi lingkungan untuk Anda. Perlakukan kunci seperti kata sandi: konfirmasikan apa yang akan ditulis agen dan di mana, jangan pernah mengirimkannya ke layanan yang tidak tepercaya atau obrolan publik/bersama, terbitan, repositori, atau tiket. Minta agen untuk tidak mengulangi kunci, menyimpan salinan, memasukkannya ke dalam kode sumber, perintah, log, atau riwayat shell, atau menerapkannya. Cabut kuncinya dan segera buat yang baru jika menurut Anda kunci tersebut mungkin telah terekspos.

Keterampilan tidak pernah menulis kunci ke dalam file atau perintah dan tidak pernah mencetaknya. Akun yang dibuat melalui Castaly sudah memiliki kunci bernama Castaly yang merutekan ke setiap grup yang tidak terkunci; kunci lain dengan grup gambar atau video juga berfungsi.

3. Minta medianya

Section titled “3. Minta medianya”

Bicaralah dengan agen Anda seperti biasa:

  • “Buat poster observatorium pantai berukuran 16:9 saat senja dengan gpt-image-2.”
  • “Ubah bingkai awal ini menjadi video 1080p berdurasi 5 detik dengan Seedance.”
  • “Model video manakah yang di bawah 0,10 USD per detik yang dapat melakukan gambar-ke-video?”

Agen membaca SKILL.md, mengambil katalog langsung dari https://modelflare.dev/api/pricing untuk melihat model mana yang dapat digunakan kunci dan berapa biayanya, lalu membuka halaman model itu sendiri di situs dokumen untuk isi permintaan, tabel parameter, dan batas yang tepat, dan memanggil API dengan klien HTTP-nya sendiri. Setiap panggilan membawa header X-Modelflare-Skill: modelflare-media/1.0, sehingga log penggunaan menunjukkan permintaan mana yang datang dari skill tersebut.

4. Dari meja kerja Castaly

Section titled “4. Dari meja kerja Castaly”

Setiap generasi di Meja kerja Castaly memiliki panel “Reproduksi ini di agen Anda sendiri” dengan pesan penginstalan, zip, dan ringkasan tugas. Kirim pesan penginstalan satu kali, lalu tempelkan ringkasannya, dan agen akan mereproduksi model dan parameter yang sama terhadap kunci Anda sendiri.

Apa yang tidak dilakukan oleh keterampilan tersebut

Section titled “Apa yang tidak dilakukan oleh keterampilan tersebut”
  • Ini tidak memberi tahu agen Anda cara kerjanya. Percobaan ulang, pengelompokan, dan apa yang harus dilaporkan kembali adalah urusan Anda dan agen Anda; keterampilannya hanya mendokumentasikan API.
  • Ia tidak membawa daftar modelnya sendiri. Katalog dan setiap kontrak permintaan dibaca secara langsung, sehingga model yang diterbitkan hari ini dapat digunakan saat ini.
  • Itu tidak mengunggah file ke penyimpanan apa pun: gambar referensi lokal disematkan dalam permintaan sebagai URL data, jadi jaga agar tetap kecil (beberapa MB).
  • Tidak dapat membuka kunci grup model. Jika API menjawab model_unavailable, model tersebut tidak tersedia untuk akun ini.

Tata letak paket

Section titled “Tata letak paket”
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

Paket tidak membawa data model, sehingga tidak menjadi basi; instal ulang hanya untuk mengambil versi keterampilan baru.