GPT Image 2.5 API kini tersedia. Buat dan edit gambar →
PoYoPoYo

PoYo MCP Server

Setiap model PoYo, langsung di AI Agent Anda.

Hubungkan sekali agar Codex, Claude Code, Cursor, dan VS Code dapat mencari model gambar, video, audio, chat, dan 3D, membaca skema serta harga publik terkini, lalu menjalankan tugas melalui PoYo.

MCP adalah koneksi aman yang memungkinkan AI Agent menggunakan model PoYo tanpa Anda harus menulis permintaan API.

npx -y @poyoapi/mcp

Bridge stdio lokal untuk VS Code atau klien khusus stdio. Memerlukan Node.js 20+; gunakan penyiapan terpandu di bawah.

Buat kunci APISetup tampilanBaca dokumen MCP

Konfigurasi

Hubungkan dalam tiga langkah. Buka konfigurasi lanjutan hanya saat Anda perlu membatasi kategori atau model.

1

Siapkan API Key

Buat PoYo API Key terlebih dahulu. Klien akan menggunakannya saat terhubung.

Jangan tempelkan API Key asli ke file konfigurasi bersama atau URL.

Buat kunci API
2

Pilih klien dan temukan konfigurasinya

Pilih aplikasi yang Anda gunakan untuk melihat satu lokasi konfigurasi yang relevan.

Jalur yang disarankan

Buka Settings Codex, pilih MCP servers, lalu Add server dan Streamable HTTP.

Lihat petunjuk resmi klien

File konfigurasi manual

~/.codex/config.toml

Berlaku untuk

Semua proyek pengguna saat ini

Buka konfigurasi MCP di klien. Jika tidak ada pintasan visual, buka atau buat file di atas.

Jalur yang diawali ./ berada di dalam proyek yang sedang dibuka. Buat folder atau file jika diperlukan.

3

Tambahkan konfigurasi dan verifikasi

Salin konfigurasi klien yang dipilih, muat ulang MCP, lalu selesaikan verifikasi gratis.

Gabungkan konfigurasi yang ada; jangan menimpanya

Jika file sudah berisi MCP Server lain, gabungkan hanya entri server poyo dan pertahankan semua isi yang ada.

Tambahkan konfigurasi berikut ke ~/.codex/config.toml

[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45

Simpan API Key sebagai variabel lingkungan POYO_API_KEY sebelum memulai klien. Setelah menyimpan, mulai sesi Codex baru agar konfigurasi MCP dimuat ulang.

Bagaimana cara mengatur POYO_API_KEY?

Salin perintah untuk sistem Anda, ganti your_api_key dengan Key asli, lalu mulai klien dari sesi terminal yang sama.

macOS / Linux

export POYO_API_KEY="your_api_key"

Windows PowerShell

$env:POYO_API_KEY="your_api_key"

Perintah ini hanya berlaku untuk sesi terminal saat ini. Jangan simpan Key asli di file proyek, tangkapan layar, atau log perintah publik.

Baca dokumen MCP
Minta Agent membantu konfigurasi

Salin Prompt aman yang mempertahankan pengaturan lama, menjaga Key asli di luar file, dan menampilkan diff sebelum menulis.

Verifikasi koneksi

Periksa status berikut secara berurutan. Tidak ada yang memulai tugas model berbayar.

  1. 1Alat PoYo muncul di klien: konfigurasi telah dimuat.
  2. 2poyo_account mengembalikan informasi akun: API Key berfungsi.
  3. 3poyo_search_models mengembalikan model: katalog dapat diakses.
Koneksi tidak berfungsi?
  • Alat tidak muncul: periksa lokasi konfigurasi lalu muat ulang MCP Server.
  • Pemeriksaan akun gagal: periksa POYO_API_KEY lalu mulai ulang klien dari lingkungan yang sama.
  • Koneksi gagal: pastikan endpoint https://api.poyo.ai/mcp dan jaringan atau proxy mengizinkan HTTPS.

Jika alat, akun, dan katalog lolos pemeriksaan, PoYo MCP telah terhubung.

Apa yang bisa dilakukan agen dengan PoYo MCP?

Jelaskan tugas dalam bahasa alami. Agen mencari model yang cocok, membaca input dan harga, mengeksekusi, dan mengembalikan hasil ketika pekerjaan panjang selesai.

Menemukan model

Cari gambar, video, audio, obrolan, atau model 3D saat ini dari tugas bahasa alami

poyo_search_models
Model kandidat

Baca input

Baca skema input saat ini, contoh, protokol, dan kemampuan

poyo_get_model_schema
Masukan yang valid

Periksa harga

Baca harga publik saat ini sebelum menjalankan permintaan berbayar

poyo_get_pricing
Konfirmasi harga

Mengikuti tugas singkat

Meng selesaikan tugas chatting atau generasi yang dapat kembali setelah menunggu singkat

poyo_chatpoyo_run_model
Hasil lengkap

Terus bekerja lama

Kirimkan tugas yang sudah lama berjalan, simpan task_idnya, dan baca status dan output nanti

poyo_submit_jobpoyo_check_job
Status dan output

Baca akun

Baca informasi rekening arus dan kredit sebelum pelaksanaan model

poyo_account
Status akun

Kapan Anda harus menggunakan MCP, CLI, atau REST API?

Gunakan MCP ketika agen harus memilih dan memanggil model, PoYo CLI untuk otomatisasi terminal atau CI, dan REST API untuk lalu lintas aplikasi atau output token per token.

01

Asisten AI atau agen pengkodean

Pilihlah

MCP

Berjalan HTTP

Mengapa cocok

Biarkan agen menemukan model, membaca skema dan harga, dan memanggil alat dalam editor atau percakapan.

Kau mengendalikan

Ruang lingkup alat dan izin klien

Baca dokumen
02

Skrip terminal atau CI

Pilihlah

PoYo CLI

@poyoapi/cli

Mengapa cocok

Temukan model, menjalankan generasi, menunggu pekerjaan, dan memancarkan JSON, JSONL, atau CSV dari shell.

Kau mengendalikan

Bendera perintah, file input, dan format output

Baca dokumen
03

Backend aplikasi Anda

Pilihlah

REST API

HTTP + JSON / SSE

Mengapa cocok

Mengelola lalu lintas aplikasi, streaming token, polling, webhook, dan pekerjaan batch.

Kau mengendalikan

Permintaan siklus hidup dan pengalaman produk

Baca dokumen

Pertanyaan yang sering diajukan

Pelajari tentang koneksi MCP, kunci API, ruang lingkup alat, tagihan, dan pemulihan pekerjaan lama.

Buat kunci API, ikuti dokumentasi MCP untuk menambahkan PoYo untuk klien Anda, kemudian memeriksa akun Anda, skema model, dan harga publik.

Buat kunci APIBaca dokumen MCP