GPT Image 2.5 API yayında. Görseller oluşturun ve düzenleyin →
PoYoPoYo
PoYo CLInpm paketi hazır

PoYo modellerini keşfedin ve çalıştırın doğrudan terminalinizden.

Canlı model kataloğunu API Key olmadan arayın ve Schema verilerini inceleyin. Sohbet akışı, üretim veya task_id ile görev sürdürme için hazır olduğunuzda kimlik doğrulayın.

$npx -y @poyoapi/cli help
npm'de görüntüleGitHubDokümanı aç

PoYo CLI'yi üç adımda kullanmaya başlayın

CLI'yi çalıştırın, ardından models ve describe ile bir model seçin. API Key yalnızca model çalıştırırken veya hesap verilerini okurken gerekir.

1

CLI'ı çalıştırın

Global kurulum olmadan npx kullanın. Yayınlanan paket Node.js 20 veya üzerini gerektirir.

node --version
npx -y @poyoapi/cli help
2

Model seçin

Bu örnek, şu anda kullanılabilir olan gpt-image-2 modelini bulur, ardından güncel giriş Schema'sını ve herkese açık fiyatını okur. İki komut için de API Key gerekmez.

npx -y @poyoapi/cli models image --q gpt-image-2 --limit 1
npx -y @poyoapi/cli describe gpt-image-2
3

Doğrulayın ve çalıştırın

Bir API Key oluşturun ve aşağıdaki üç komutu sırayla çalıştırın. Ücretli çalıştırmadan önce describe ile fiyatı kontrol edin; başarısız üretimler kredi tüketmez.

API Key oluştur

1. API Key'i kaydet

Beklenen sonuç: CLI Key'i göstermeden ister ve ardından saklama konumu olarak keyring veya config bilgisini verir. Sistem kimlik bilgisi deposu kullanılamıyorsa mevcut kullanıcının PoYo yapılandırma dosyasına geçer.

npx -y @poyoapi/cli auth login

2. Hesabı ve bakiyeyi doğrula

Beklenen sonuç: hesap bilgileri ve kullanılabilir bakiye. 401, Key'in eksik veya geçersiz olduğu anlamına gelir.

npx -y @poyoapi/cli account

3. Fiyatı onayla ve çalıştır

Bu ücretli bir istektir. Başarılı JSON sonucu task_id, son durum ve çıktı dosyalarını içerir.

npx -y @poyoapi/cli run gpt-image-2 --prompt "cinematic product photo" --format json

Model Schema'sını CLI argümanlarına dönüştürün

chat, run veya submit öncesinde CLI seçilen modelin Schema'sını okur ve alanları modele özel argümanlara dönüştürür.

Çalıştırmadan önce arayın

models açık kataloğu listeler. describe Schema, protokol, çalışma modu, callback ve faturalandırmayı döndürür.

Bu iki komut API Key gerektirmez.

Üretim promptu

Schema string alanı normal komut satırı değeri olarak kabul edilir.

Bilinmeyen model seçenekleri yerelde hata verir. Tam JSON Schema doğrulaması API'de yapılır.

Şimdi dönün, sonra sürdürün

submit hemen task_id döndürür. task get durumu okur, task wait beklemeyi sürdürür.

Video, ses, 3D ve diğer uzun işler için uygundur.

CLI çıktı biçimini kontrol edin

Akışlı chat, metin veya JSONL verisini stdout'a yazar. Akışsız komutlar table, JSON, JSONL ya da CSV döndürebilir ve sonucu bir dosyaya yazabilir.

CLI, REST API ile aynı endpoint ve faturalandırma davranışını kullanır.

Her görev için doğru komutu seçin

Model keşfi, sohbet, üretim, görev sürdürme ve yerel MCP köprüsü ayrı komutlarla çalışır.

~/projects/poyo-demo
# 1. Model seçin
$ npx -y @poyoapi/cli models image --q gpt-image-2 --limit 1

# 2. Oluşturulan komut girdisi
$ npx -y @poyoapi/cli describe gpt-image-2
  prompt          string   required
  size            string   default: "1:1"
  output_format   string   enum: jpeg | png

# 3. Doğrulayın ve çalıştırın
$ 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"]
}

Görev yaşam döngüsü

Uzun görevleri task_id ile sürdürün

PoYo mevcut genel görev durumunu doğrudan döndürür. CLI zaman aşımına uğrar veya kapanırsa yeniden göndermek yerine aynı görevi sorgulayın.

CLI timeout backend görevini iptal etmez. Yeniden ödeme yapmak yerine aynı task_id ile devam edin.

Uzun işler için submit
$ npx -y @poyoapi/cli submit gpt-image-2 --prompt "cinematic product photo" --format json

task_id task_7f31b2

$ npx -y @poyoapi/cli task wait TASK_ID --timeout 300 --format json

status succeeded

Sınırlı bekleme için run

run iki saniyede bir sorgular ve varsayılan olarak en fazla 90 saniye bekler.

Uzun işler için submit

task_id değerini saklayın; başka terminal veya CI adımında task get ya da task wait kullanın.

CLI, MCP, REST ve Skill arasında seçim yapın

Terminal ve CI için CLI, Agent araç çağrıları için MCP, uygulamalar için REST API, tekrarlanabilir Agent iş akışları için Skill kullanın.

PoYo CLI

Geliştiriciler, terminal ve CI

Kişi veya betik keşif, çalışma, sürdürme ve çıkış kodlarına ihtiyaç duyar.

CLI kur

MCP

AI Agent'lar ve kod istemcileri

Agent tek bağlantıyla Schema, fiyat ve araçları keşfetmelidir.

MCP'yi gör

REST API

Uygulamalar ve servisler

Ürününüz orkestrasyon, akış, yeniden deneme ve trafiği kontrol eder.

Dokümanı aç

PoYo Skill

Tekrarlanabilir Agent akışları

Agent arayüzlerin yanında çalışma talimatları ve güvenlik kuralları ister.

Skill'i gör

PoYo CLI SSS

Bir komuttan hâlâ emin değil misiniz? PoYo destek ile iletişime geçin→

İlk PoYo modelinizi terminalden çalıştırın

Önce açık kataloğu inceleyin, bir model çalıştırmaya hazır olduğunuzda API Key oluşturun.

API Key oluşturnpm'de görüntüle