Berikan alur kerja OmniaKey kepada agen, dari pemilihan model hingga hasil akhir.
01
Pasang alat
Pasang Skill di proyek saat ini, pilih agen dan muat ulang. Hubungkan juga MCP atau pasang CLI; Skill menyediakan petunjuk.
npx skills add omniakey-com/omniakey-devtools --skill omniakey-models02
Hubungkan kunci API
Tempel kunci pada input tersembunyi di terminal, lalu tekan Enter. Jalankan agen dari lingkungan ini; jangan masukkan kunci ke prompt atau repositori.
Dapatkan kunci APIread -s OMNIAKEY_API_KEY
export OMNIAKEY_API_KEY$env:OMNIAKEY_API_KEY = [System.Net.NetworkCredential]::new('', (Read-Host 'OmniaKey API key' -AsSecureString)).Password03
Periksa tanpa membuat konten
Minta agen memuat omniakey-models dan menjalankan pemeriksaan. Memasang Skill saja tidak mengatur kunci API atau alat eksekusi.
Pastikan OmniaKey MCP atau CLI siap. Tampilkan model yang dapat diakses dan baca skema umum permintaan media. Jangan kirim tugas pembuatan konten.Temukan model
Lihat model yang dapat diakses kunci API Anda, lalu periksa kemampuan dalam dokumentasi dan harga terkini.
Kirim permintaan
Gunakan API OmniaKey yang sama untuk teks dan tugas asinkron gambar, video, atau audio.
Lanjutkan tugas
Simpan id tugas dan lanjutkan pemeriksaan. Batas waktu lokal tidak memulai pembuatan konten kedua.
Dari input ke hasil
Setelah CLI terpasang, simpan contoh sebagai image.json. Periksa model dan harga sebelum permintaan berbayar ini. Ganti TASK_ID dengan id yang diterima.
omniakey submit --file image.json --idempotency-key YOUR_UNIQUE_TASK_KEY
omniakey task wait TASK_ID --timeout 300
omniakey task get TASK_ID04
Apa yang diajarkan Skill
Agent Skill adalah kumpulan instruksi, bukan lingkungan eksekusi. Ia memberi agen alur yang bisa diulang; server MCP atau CLI yang melakukan panggilan.
Temukan model sebelum memilih
Kueri model yang tersedia untuk kunci API saat ini daripada mengandalkan nama yang diingat.
Baca dokumentasi model itu sendiri
Periksa masukan yang didukung dan harga terbaru di halaman model sebelum menyusun permintaan.
Gunakan kunci idempotensi
Simpan kunci stabil per pembuatan agar respons yang hilang tidak menjadi tagihan ganda.
Lanjutkan tugas, jangan mulai ulang
Simpan id yang dikembalikan dan kueri id itu. Batas waktu lokal tidak pernah membenarkan pengiriman baru.
Laporkan hasil dengan tepat
Bedakan tugas di antrean dari tugas selesai dan sebutkan bila tugas gagal atau dibatalkan.
Tangani kredensial dengan hati-hati
Baca kunci dari lingkungan dan jauhkan dari prompt, log, dan file repositori.
05
Opsi pemasangan
Pemasang menulis Skill ke proyek saat ini secara bawaan. Pilih agen Anda atau pasang global agar bisa dibagi antarproyek.
npx skills add omniakey-com/omniakey-devtools --skill omniakey-models --agent codexnpx skills add omniakey-com/omniakey-devtools --skill omniakey-models --agent claude-codenpx skills add omniakey-com/omniakey-devtools --skill omniakey-models --global06
Status tugas
Skill memeriksa status sebelum bertindak. Berikut status yang bisa ditemuinya.
| Status | Arti | Langkah berikut |
|---|---|---|
| queued | Diterima dan menunggu worker. | Tunggu atau kueri id yang sama. |
| processing | Berjalan; hasil belum siap. | Lanjutkan kueri; jangan kirim ulang. |
| succeeded | Selesai dengan aset tersedia. | Pakai URL bertanda tangan sebelum kedaluwarsa. |
| failed | Selesai tanpa hasil; kredit yang ditahan dikembalikan. | Baca kesalahan, perbaiki permintaan, dan kirim tugas baru. |
| canceled | Pembatalan selesai. | Kirim tugas baru hanya jika keluaran masih dibutuhkan. |
07
Bekerja dengan MCP atau CLI
Skill menyediakan alur; ia tidak memanggil API sendiri. Hubungkan server MCP OmniaKey atau pasang CLI agar agen punya jalur eksekusi. Pemasangan saja tidak mengonfigurasi kunci.
08
Tentang alat ini
Versi terkunci v0.1.0
Alat pengembang OmniaKey bersumber terbuka dan dirilis sebagai paket GitHub bertag. Halaman ini mendokumentasikan permukaan perintah dan perilaku versi itu.
- Lisensi
- MIT
- Arsitektur
- Klien CLI atau MCP → klien bersama → api.omniakey.com/v1
- Uji
- Uji integrasi repositori menjalankan CLI terhadap server HTTP lokal dan server MCP lewat klien stdio sungguhan. Mereka tidak menjalankan pembuatan berbayar.
- Penanganan kunci
- Situs ini tidak pernah menerima kunci API Anda. CLI dan server MCP membacanya dari lingkungan dan hanya mengirimnya ke endpoint API.
Pertanyaan umum
Apakah harga model berubah?
Tidak. Alat memakai kunci API dan aturan penagihan API yang sama. Daftar model dan pemeriksaan skema lokal tidak membuat konten; pembuatan teks atau media dapat dikenai biaya.
Apa yang terjadi saat waktu tunggu habis?
Tugas jarak jauh tidak dibatalkan atau dikirim ulang. Simpan id dan lanjutkan dengan task get atau task wait. Tautan berkas dapat kedaluwarsa; periksa tugas yang sama untuk tautan baru.
Apakah Skill layanan yang dihosting?
Tidak. Itu folder instruksi yang dipasang di proyek atau lingkungan agen Anda. Tidak ada endpoint Skill yang dihosting OmniaKey.
Apakah memasang Skill menghubungkan kunci API saya?
Tidak. Konfigurasikan OMNIAKEY_API_KEY secara terpisah untuk server MCP atau CLI. Skill memberi tahu agen cara memakai alat itu.
Apakah Skill menjalankan perintah sendiri?
Tidak. Agen Anda memutuskan kapan mengikuti instruksi dan panggilan mana yang dibuat. Pembuatan tetap butuh permintaan pengguna.