1
Memulai CLI
Gunakan npx tanpa instalasi global. Paket yang diterbitkan memerlukan Node.js 20 atau yang lebih baru.
node --version
npx -y @poyoapi/cli helpPoYo CLIpaket npm tersedia
Menemukan dan menjalankan PoYo model dari terminal Anda.
Cari katalog model live dan memeriksa skema tanpa kunci API. Otentikasi saat Anda siap untuk menstrim obrolan, mengirimkan pekerjaan generasi, atau melanjutkan tugas dengan task_id.
$npx -y @poyoapi/cli helpMulai menggunakan PoYo CLI dalam tiga langkah
Jalankan CLI, kemudian gunakan model dan deskripsi untuk memilih model. Tambahkan kunci API hanya ketika Anda menjalankan model atau membaca data akun.
2
Pilih model
Contoh ini mencari model gpt-image-2 yang saat ini tersedia, lalu membaca Schema input terbaru dan harga publiknya. Kedua perintah tersebut tidak memerlukan API Key.
npx -y @poyoapi/cli models image --q gpt-image-2 --limit 1
npx -y @poyoapi/cli describe gpt-image-23
Otentikasi dan eksekusi
Buat API Key, lalu jalankan tiga perintah di bawah secara berurutan. Periksa harga dengan describe sebelum menjalankan permintaan berbayar; generasi yang gagal tidak memakai kredit.
Buat kunci API1. Simpan API Key
Hasil yang diharapkan: CLI meminta Key tanpa menampilkannya, lalu melaporkan keyring atau config sebagai lokasi penyimpanan. Jika penyimpanan kredensial sistem tidak tersedia, CLI memakai file konfigurasi PoYo milik pengguna saat ini.
npx -y @poyoapi/cli auth login2. Verifikasi akun dan saldo
Hasil yang diharapkan: detail akun dan saldo yang tersedia. Status 401 berarti Key tidak ada atau tidak valid.
npx -y @poyoapi/cli account3. Konfirmasi harga dan jalankan
Ini adalah permintaan berbayar. Hasil JSON yang berhasil berisi task_id, status akhir, dan file keluaran.
npx -y @poyoapi/cli run gpt-image-2 --prompt "cinematic product photo" --format jsonMengubah skema model menjadi argumen CLI
Sebelum mengobrol, menjalankan, atau mengirimkan, CLI membaca Schema model yang dipilih dan mengubah bidangnya menjadi argumen khusus model.
Cari sebelum mengeksekusi
model daftar katalog publik. menjelaskan mengembalikan skema yang tepat, protokol yang didukung, mode eksekusi, dukungan panggilan balik, dan metadata tagihan untuk satu model.
Kedua perintah ini tidak memerlukan kunci API.
Prompt pembuatan
Sebuah string Schema diterima sebagai nilai baris perintah normal.
Bendera model yang tidak diketahui gagal secara lokal. Bidang yang diperlukan dan lengkap JSON Validasi skema masih terjadi pada API.
Kembali sekarang dan pulih nanti
submit mengembalikan task_id segera. Task get membaca keadaan saat ini, sementara task wait terus memilih sampai selesai atau deadline.
Gunakan jalur ini untuk video, audio, 3D, dan pekerjaan lama lainnya.
Kontrol bagaimana CLI mengembalikan output
Streaming chat menulis teks atau JSONL ke stdout. Komando non-streaming dapat mengembalikan tabel, JSON, JSONL, atau CSV output dan menulisnya ke file.
Permintaan CLI menggunakan yang sama PoYo titik akhir dan perilaku penagihan sebagai REST API calls.
Pilih perintah yang tepat untuk setiap tugas
Perintah terpisah menangani penemuan model, obrolan, generasi, pemulihan tugas, dan jembatan MCP lokal.
~/projects/poyo-demo
# 1. Pilih model
$ npx -y @poyoapi/cli models image --q gpt-image-2 --limit 1
# 2. Generasi input perintah
$ npx -y @poyoapi/cli describe gpt-image-2
prompt string required
size string default: "1:1"
output_format string enum: jpeg | png
# 3. Otentikasi dan eksekusi
$ npx -y @poyoapi/cli run gpt-image-2 --prompt "cinematic product photo" --size 4:3 --output-format png --format json
{
"task_id": "task_7f31b2",
"status": "succeeded",
"files": ["https://storage.poyo.ai/.../image.png"]
}Siklus hidup tugas
Memulai kembali tugas yang sudah lama dengan task_id
PoYo mengembalikan status tugas publik yang ada secara langsung. Jika CLI keluar atau keluar, carilah tugas yang sama alih-alih mengirimkan lagi.
Waktu CLI tidak membatalkan pekerjaan backend. Terus dengan task_id yang sama alih-alih membayar permintaan duplikat.
Gunakan submit untuk pekerjaan panjang
$ npx -y @poyoapi/cli submit gpt-image-2 --prompt "cinematic product photo" --format jsontask_id task_7f31b2
$ npx -y @poyoapi/cli task wait TASK_ID --timeout 300 --format jsonstatus succeeded
Gunakan lari untuk menunggu terbatas
menjalankan polling setiap dua detik dan menunggu sampai 90 detik kecuali Anda memilih waktu lain.
Gunakan submit untuk pekerjaan panjang
Simpan task_id yang dikembalikan, lalu gunakan task get atau task wait dari terminal atau langkah CI lainnya.
Pilih antara CLI, MCP, REST, dan Skill
Menggunakan CLI di terminal dan CI, MCP untuk panggilan alat agen, REST API dalam aplikasi, dan keterampilan untuk alur kerja agen yang berulang.
PoYo CLI
Pengembang, terminal, dan CI
Seseorang atau skrip membutuhkan penemuan, eksekusi, pemulihan tugas, dan kode keluar proses.
Instal CLIMCP
Agen AI dan klien pengkodean
Agen harus menemukan skema, harga, dan alat eksekusi melalui satu koneksi.
Lihat MCPREST API
Aplikasi dan layanan
Produk Anda memiliki orkestrasi permintaan, streaming transportasi, retries, dan lalu lintas aplikasi.
Dokumen terbukaPoYo Keterampilan
Aliran kerja agen yang dapat diulang
Agen membutuhkan instruksi operasi dan aturan keselamatan selain antarmuka yang dapat dipanggil.
Lihat SkillPoYo FAQ CLI
Masih tidak yakin tentang perintah? Kontak PoYo dukungan→
PoYo CLI adalah klien baris perintah yang didorong katalog untuk menemukan dan menelepon PoYo chat, gambar, video, audio, dan model 3D. Ini membaca Katalog Capability live, mengubah bidang Schema model menjadi opsi perintah, dan menggunakan yang sama PoYo API titik akhir untuk eksekusi dan status tugas.
models dan describe membaca Capability Catalog publik tanpa kredensial. Chat, generasi, tugas, akun, dan eksekusi berbayar memerlukan API Key.
run menunggu 90 detik secara default. Timeout menghentikan polling lokal tetapi tidak membatalkan tugas backend. Lanjutkan dengan npx -y @poyoapi/cli task wait TASK_ID.
Simpan Key di pengelola rahasia CI dan berikan sebagai POYO_API_KEY. Kunci versi dengan @poyoapi/cli@VERSION, gunakan --format json, dan anggap kode keluar selain nol sebagai kegagalan. Jangan simpan kredensial di riwayat perintah atau repositori.
Tidak. CLI menggunakan endpoint yang sama. describe menampilkan harga publik dan account menampilkan saldo saat ini. run dan submit berbayar; kredit hanya dipotong setelah generasi berhasil. 401 berarti Key hilang atau tidak valid, sedangkan 402 berarti kredit tidak cukup.
Perintah ini menjalankan bridge stdio yang meneruskan JSON-RPC ke https://api.poyo.ai/mcp. Eksekusi model tetap berlangsung di layanan jarak jauh PoYo.
Berjalanlah dulu. PoYo model dari terminal
Browse Catalog publik pertama, kemudian membuat kunci API ketika Anda siap untuk mengeksekusi model.