GPT Image 2.5 API đã ra mắt. Tạo và chỉnh sửa hình ảnh ngay →
PoYoPoYo
Tất cả tích hợp

Hướng dẫn tích hợp

Cài đặt PoYo cho ComfyUI

Quy trình AI trực quan trên máy cục bộ

Dùng các mô hình hình ảnh, video và âm thanh PoYo cùng các node ComfyUI cục bộ, với kết nối trực quan và đầu ra tệp.

Trước khi bắt đầu

  • ComfyUI 0.32.0 trở lên
  • Git và một PoYo API Key

Ba bước để cài đặt và xác minh

Thực hiện lần lượt từng bước. Mỗi bước đều chỉ rõ nơi cần thao tác và kết quả cần thấy trước khi tiếp tục.

  1. 1

    Kiểm tra phiên bản ComfyUI

    Cập nhật ComfyUI trước khi cài gói node nếu phiên bản hiện tại thấp hơn 0.32.0.

    Tiếp tục khi: ComfyUI báo phiên bản 0.32.0 trở lên.
  2. 2

    Cài các node và khởi động lại ComfyUI

    Clone kho mã chính thức vào custom_nodes rồi khởi động lại hoàn toàn ComfyUI để tải gói mới.

    Terminal
    cd ComfyUI/custom_nodes
git clone https://github.com/PoyoAPI/poyo-comfyui.git
    Tiếp tục khi: Khi tìm PoYo trong menu node, các node PoYo đã cài đặt xuất hiện.
  3. 3

    Cấu hình API Key

    Đặt Key trước khi khởi động ComfyUI hoặc dùng lệnh cấu hình cục bộ. Không dán Key vào các trường của node trong quy trình.

    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
    Cấu hình cục bộ thay thế
    python -m poyo_nodes.configure
    Tiếp tục khi: Các node PoYo tải được danh mục mô hình trực tiếp mà không có lỗi xác thực.

Chạy quy trình PoYo đầu tiên

Dùng mẫu chính thức để kiểm tra cài đặt và thông tin xác thực trước khi xây dựng quy trình lớn hơn.

Chọn một quy trình mẫu

Bắt đầu với một quy trình nhỏ phù hợp với hành vi bạn muốn kiểm tra.

Gửi và chờ kết quả

Gửi một mô hình bất kỳ từ danh mục, chờ hoàn tất rồi lưu tệp kết quả.

Xem trên GitHubTải JSON
Cách nhập
  1. 1Tải tệp JSON.
  2. 2Kéo tệp vào canvas ComfyUI hoặc chọn Workflow → Open.
  3. 3Chọn mô hình, xác nhận đầu vào rồi chọn Queue Prompt.
  1. 1Tải một quy trình mẫu chính thức từ kho mã.
  2. 2Mở trong ComfyUI và chọn mô hình từ danh mục trực tiếp.
  3. 3Đưa prompt vào hàng đợi và chờ tác vụ PoYo hoàn tất.
  4. 4Tìm kết quả đã lưu trong ComfyUI/output/poyo.

Kết quả thành công đầu tiên: Hàng đợi hoàn tất và kết quả đã tạo có trong ComfyUI/output/poyo.

Nếu có lỗi

Các node PoYo không xuất hiện
Khởi động lại hoàn toàn ComfyUI và kiểm tra console khi khởi động để tìm lỗi nhập poyo_nodes.
Không tải được danh mục
Kiểm tra API Key và kết nối mạng, rồi khởi động lại sau khi thay đổi biến môi trường.
Quy trình không tìm thấy đầu ra
Chờ tác vụ đạt trạng thái finished, rồi kiểm tra node Save Result File và ComfyUI/output/poyo.
Chi tiết kỹ thuật

Những thông tin này quan trọng khi triển khai thực tế nhưng không phải điều kiện để chạy thành công lần đầu.

  • Thông tin xác thực không được ghi vào tệp quy trình đã xuất.
  • Tác vụ giữ nguyên các trạng thái công khai not_started, running, finished và failed.
  • Yêu cầu gọi trực tiếp các endpoint REST hiện có của PoYo và kèm thẻ X-PoYo-Source.
Tạo API KeyMở kho GitHub