Official n8n community node for PoYo AI. It uses PoYo's live model catalog and existing REST APIs to run image, video, audio, 3D, and chat models.
Install n8n-nodes-poyo from Settings → Community Nodes. For self-hosted n8n, you can also include the package in N8N_COMMUNITY_PACKAGES.
Create a PoYo API key in the PoYo dashboard, then create a PoYo API credential in n8n. The default API URL is https://api.poyo.ai.
- Account: get the authenticated balance.
- Models: list/search the live catalog and inspect a model schema.
- Jobs: submit, get status, wait, or run and wait.
- Files: upload n8n binary data and download result URLs.
- Chat: call OpenAI Chat, OpenAI Responses, Anthropic, or Gemini-compatible endpoints.
- Webhook: verify PoYo callback signatures.
The job node preserves PoYo's existing statuses: not_started, running, finished, and failed. It does not introduce a second status model.
Choose Input Mode → Generic JSON and pass the exact input object shown in the selected model's catalog schema. New catalog models can be used without updating this package.
Friendly Image, Video, and Audio modes add a prompt and media URL field on top of the JSON input. Because models use different media field names, enter the exact field from the model schema, such as image_urls, video_url, or audio_url.
Use Run and Wait for polling. The default interval is 3 seconds and the default timeout is 60 minutes. The node keeps polling for not_started and running, returns on finished, and fails on failed.
For callbacks, pass a webhook or Wait resume URL when submitting. Verify the callback with the Webhook operation, then call Get Status to retrieve the authoritative result.
- API keys and webhook secrets live in encrypted n8n credentials and are not stored in workflow JSON.
- Result URLs are returned without downloading unless the Download operation is used.
- Every request is attributed with
X-PoYo-Source: n8n.
npm install
npm test
npm run lint
npm run buildExample workflows are in workflows.