Panduan integrasi

Instal PoYo untuk ComfyUI

Alur kerja AI visual lokal

Gunakan model gambar, video, dan audio PoYo bersama node ComfyUI lokal, dengan koneksi visual dan keluaran file.

Sebelum memulai

Selesaikan langkah secara berurutan. Setiap langkah menjelaskan tempat bertindak dan hasil yang memastikan Anda dapat melanjutkan.

1
Periksa versi ComfyUI
Perbarui ComfyUI sebelum menginstal paket node jika versinya lebih lama dari 0.32.0.
Lanjutkan ketika: ComfyUI melaporkan versi 0.32.0 atau lebih baru.
2
Instal node dan mulai ulang ComfyUI
Clone repositori resmi ke custom_nodes, lalu mulai ulang ComfyUI sepenuhnya agar paket baru dimuat.
Terminal
cd ComfyUI/custom_nodes git clone https://github.com/PoyoAPI/poyo-comfyui.git
Lanjutkan ketika: Pencarian PoYo pada menu node menampilkan node PoYo yang telah diinstal.
3
Konfigurasikan API Key
Atur Key sebelum menjalankan ComfyUI atau gunakan perintah konfigurasi lokal. Jangan tempel Key ke kolom node alur kerja.
Windows
set POYO_API_KEY=your_poyo_api_key set POYO_BASE_URL=https://api.poyo.ai
macOS / Linux
export POYO_API_KEY=your_poyo_api_key export POYO_BASE_URL=https://api.poyo.ai
Alternatif konfigurasi lokal
python -m poyo_nodes.configure
Lanjutkan ketika: Node PoYo dapat memuat katalog model langsung tanpa kesalahan autentikasi.

Gunakan contoh resmi untuk menguji instalasi dan kredensial sebelum membuat alur kerja yang lebih besar.

Mulai dengan alur kerja kecil yang sesuai dengan perilaku yang ingin Anda verifikasi.

Jalankan node generasi gambar PoYo yang mudah digunakan dan simpan gambar hasilnya.

Kirim model generik dari katalog, tunggu hingga selesai, lalu simpan file hasil.

Cara mengimpor

Keberhasilan pertama: Antrean selesai dan hasil generasi tersedia di ComfyUI/output/poyo.

Node PoYo tidak muncul: Mulai ulang ComfyUI sepenuhnya dan periksa konsol startup untuk kesalahan impor poyo_nodes.
Katalog tidak dapat dimuat: Periksa API Key dan koneksi jaringan, lalu mulai ulang setelah mengubah variabel lingkungan.
Alur kerja tidak menemukan keluaran: Tunggu tugas mencapai finished, lalu periksa node Save Result File dan ComfyUI/output/poyo.

Detail teknis

Detail ini penting untuk integrasi produksi, tetapi bukan prasyarat untuk menjalankan alur kerja pertama.

Kredensial tetap berada di luar file alur kerja yang diekspor.
Tugas mempertahankan status publik not_started, running, finished, dan failed.
Permintaan memanggil endpoint REST PoYo yang ada secara langsung dan menyertakan tag X-PoYo-Source.