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

PoYo MCP Server

Mọi mô hình PoYo, ngay trong AI Agent của bạn.

Kết nối một lần để Codex, Claude Code, Cursor và VS Code có thể tìm kiếm mô hình hình ảnh, video, âm thanh, trò chuyện và 3D, đọc Schema cùng giá công khai hiện tại và chạy tác vụ qua PoYo.

MCP là kết nối an toàn cho phép AI Agent sử dụng mô hình PoYo mà bạn không cần tự viết yêu cầu API.

npx -y @poyoapi/mcp

Bridge stdio cục bộ cho VS Code hoặc ứng dụng chỉ hỗ trợ stdio. Cần Node.js 20+; hãy dùng phần thiết lập bên dưới.

Tạo khóa APIThiết lập xemĐọc tài liệu MCP

Thiết lập

Kết nối trong ba bước. Chỉ mở cấu hình nâng cao khi bạn cần giới hạn danh mục hoặc mô hình.

1

Chuẩn bị API Key

Trước tiên hãy tạo PoYo API Key. Ứng dụng sẽ dùng Key này khi kết nối.

Không dán API Key thật vào tệp cấu hình được chia sẻ hoặc URL.

Tạo khóa API
2

Chọn ứng dụng và tìm vị trí cấu hình

Chọn ứng dụng bạn đang dùng để chỉ xem một vị trí cấu hình phù hợp.

Điểm thiết lập đề xuất

Mở Codex Settings, chọn MCP servers, sau đó chọn Add server và Streamable HTTP.

Xem hướng dẫn chính thức của ứng dụng

Tệp cấu hình thủ công

~/.codex/config.toml

Áp dụng cho

Tất cả dự án của người dùng hiện tại

Mở cấu hình MCP trong ứng dụng. Nếu không có điểm vào trực quan, hãy mở hoặc tạo tệp ở trên.

Đường dẫn bắt đầu bằng ./ nằm trong dự án đang mở. Hãy tạo thư mục hoặc tệp nếu cần.

3

Thêm cấu hình và xác minh

Sao chép cấu hình cho ứng dụng đã chọn, tải lại MCP và hoàn tất bước xác minh miễn phí.

Hãy hợp nhất cấu hình hiện có, không ghi đè

Nếu tệp đã có MCP Server khác, chỉ hợp nhất mục poyo và giữ nguyên toàn bộ nội dung hiện có.

Thêm cấu hình bên dưới vào ~/.codex/config.toml

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

Lưu API Key vào biến môi trường POYO_API_KEY trước khi khởi động ứng dụng. Sau khi lưu, hãy bắt đầu phiên Codex mới để tải lại cấu hình MCP.

Cách đặt POYO_API_KEY

Sao chép lệnh phù hợp với hệ điều hành, thay your_api_key bằng Key thật rồi khởi động ứng dụng từ cùng phiên terminal.

macOS / Linux

export POYO_API_KEY="your_api_key"

Windows PowerShell

$env:POYO_API_KEY="your_api_key"

Các lệnh này chỉ có hiệu lực trong phiên terminal hiện tại. Không lưu Key thật trong tệp dự án, ảnh chụp màn hình hoặc nhật ký lệnh công khai.

Đọc tài liệu MCP
Nhờ Agent hỗ trợ cấu hình

Sao chép Prompt an toàn yêu cầu giữ nguyên thiết lập, không ghi Key thật vào tệp và hiển thị diff trước khi ghi.

Xác minh kết nối

Kiểm tra các trạng thái sau theo thứ tự. Không bước nào chạy tác vụ mô hình trả phí.

  1. 1Công cụ PoYo xuất hiện trong ứng dụng: cấu hình đã được tải.
  2. 2poyo_account trả về thông tin tài khoản: API Key đã hoạt động.
  3. 3poyo_search_models trả về mô hình: có thể truy cập danh mục.
Kết nối không hoạt động?
  • Không thấy công cụ: kiểm tra vị trí cấu hình rồi tải lại MCP Server.
  • Kiểm tra tài khoản thất bại: xác nhận POYO_API_KEY rồi khởi động lại ứng dụng từ cùng môi trường.
  • Kết nối thất bại: xác nhận https://api.poyo.ai/mcp và mạng hoặc proxy cho phép HTTPS.

Khi công cụ, tài khoản và danh mục đều được xác minh, PoYo MCP đã kết nối.

Một đại lý có thể làm gì với PoYo MCP?

Mô tả một nhiệm vụ bằng ngôn ngữ tự nhiên. Người đại lý tìm kiếm một mô hình phù hợp, đọc các đầu vào và giá của nó, chạy nó, và trả lại kết quả khi một công việc dài hoàn thành.

Khám phá các mô hình

Tìm hình ảnh, video, âm thanh, trò chuyện hoặc mô hình 3D hiện tại từ một nhiệm vụ ngôn ngữ tự nhiên

poyo_search_models
Các mô hình ứng cử viên

Đăng nhập đọc

Đọc các kế hoạch đầu vào hiện tại, ví dụ, giao thức và khả năng

poyo_get_model_schema
Các đầu vào hợp lệ

Kiểm tra giá

Đọc giá công cộng hiện tại trước khi thực hiện yêu cầu trả tiền

poyo_get_pricing
Đảm nhận giá

Tiêu đề ngắn

Hoàn thành các nhiệm vụ trò chuyện hoặc tạo ra có thể trở lại sau một thời gian chờ đợi ngắn

poyo_chatpoyo_run_model
Kết quả hoàn chỉnh

Cứ tiếp tục làm việc lâu

Gửi một nhiệm vụ dài hạn, giữ task_id của nó, và đọc trạng thái và đầu ra sau đó

poyo_submit_jobpoyo_check_job
Tình trạng và sản lượng

Đọc tài khoản

Đọc thông tin tài khoản hiện tại và tín dụng trước khi thực hiện mô hình

poyo_account
Tình trạng tài khoản

Khi nào nên sử dụng MCP, CLI hoặc REST API?

Sử dụng MCP khi một đại lý phải chọn và gọi các mô hình, CLI PoYo cho tự động hóa thiết bị kết thúc hoặc CI, và REST API cho lưu lượng ứng dụng hoặc đầu ra token-by-token.

01

trợ lý AI hoặc đại lý lập trình

Chọn

MCP

Dòng phát HTTP

Tại sao nó phù hợp

Hãy để một đại lý khám phá các mô hình, đọc các kế hoạch và giá cả, và gọi các công cụ trong một biên tập viên hoặc cuộc trò chuyện.

Anh kiểm soát

Phạm vi công cụ và quyền truy cập của khách hàng

Đọc tài liệu
02

Các kịch bản cuối hoặc CI

Chọn

PoYo CLI

@poyoapi/cli

Tại sao nó phù hợp

Khám phá các mô hình, chạy sản xuất, chờ đợi công việc, và phát ra JSON, JSONL, hoặc CSV từ một vỏ.

Anh kiểm soát

Cờ lệnh, tệp nhập và định dạng xuất

Đọc tài liệu
03

Phần sau của ứng dụng của bạn

Chọn

REST API

HTTP + JSON / SSE

Tại sao nó phù hợp

Chống lại lưu lượng ứng dụng, phát token, thăm dò, webhooks và các công việc hàng loạt.

Anh kiểm soát

Yêu cầu chu kỳ đời và kinh nghiệm sản phẩm

Đọc tài liệu

Những câu hỏi thường được hỏi

Tìm hiểu về các kết nối MCP, khóa API, phạm vi công cụ, thanh toán và phục hồi công việc dài.

Tạo khóa API, theo tài liệu MCP để thêm PoYo vào khách hàng của bạn, sau đó kiểm tra tài khoản, mô hình sơ đồ và giá cả công cộng của bạn.

Tạo khóa APIĐọc tài liệu MCP