使用 PoYo 构建
通过一个 API Key 调用图像、视频、音频、音乐、3D 和对话模型。先完成一次模型调用,再为你的应用选择 REST、CLI、MCP 或 Agent Skill。欢迎使用 PoYo.ai。👋 本指南介绍模型、认证、请求流程、限制和支持渠道。我们力求透明、务实、对开发者友好。上线生产环境前请先阅读。
获取 API Key
创建 API Key,并配置用量限制或 IP 白名单。
发起第一个请求
使用 cURL、Python 或 JavaScript 提交任务。
在 AI Agent 中使用
三步即可在 Claude Code、Codex 或 Cursor 中生成内容。
浏览模型与价格
对比模型能力,在 Playground 中测试,并查看价格。
1. 可用模型与 Playground
每个模型类别都有一个概览页,列出全部模型、对应的 model ID 以及获取结果的方式:图像
文生图与图像编辑。
视频
文本、图像和参考素材生成视频。
LLM
GPT、Claude、Gemini、DeepSeek、Grok 和 Kimi。
3D
文本和图像生成 3D 网格。
音乐与音频
Suno 音乐、TTS 和音频工具。
AI 工具
翻译、超分辨率放大、背景移除和内容审核。
- 新模型一旦稳定,我们就会持续更新并上线。
- 每个模型页面都链接到对应的 Playground,你可以在调用 API 之前直接在我们的界面中测试和试验。
- Playground 是了解模型行为、参数和输出格式的最佳位置。
2. 选择集成方式
REST API
适用于任意语言的产品集成。
PoYo CLI
本地测试、脚本、CI 和流式对话。
MCP
让 Claude、Cursor、Codex 或 VS Code 发现并运行模型。
Agent Skill
教会 Agent 推荐的发现与执行流程。
3. 创建并保护你的 API Key
在 API Key 页面创建和管理你的 API Key。 为帮助保护你的用量,我们提供:- 按 API Key 设置的速率限制(每小时、每天和总用量上限)
- IP 白名单,只允许经批准的服务器 IP 访问 API
4. 必需的请求头
每个 API 请求都必须包含正确的请求头:/v1/messages)也接受 x-api-key: <YOUR_API_KEY>,因此官方 Anthropic SDK 无需修改即可使用。
缺少或无效的 API Key 会返回什么
缺少或无效的 API Key 会返回什么
5. 发起第一个生成请求
生成是异步的。提交任务,保存其task_id,然后轮询任务状态或接收 Webhook。
- cURL
- Python
- JavaScript
提交成功只表示任务已被接受,不表示生成已经完成。
6. 获取结果
7. 日志与任务详情
在任务历史页面查看你的所有历史任务。每个任务都可以查看:- 创建时间
- 使用的模型
- 输入参数
- 任务状态
- 最终结果或错误详情
8. 数据保留策略
9. 异步任务模型
PoYo.ai 上的所有生成任务都是异步的。请求成功时返回 HTTP 200 和task_id。200 响应只表示任务已创建,不表示已完成。
1
提交
发送生成请求,并保存返回的
task_id。2
等待结果
在请求中提供回调(Webhook)URL,或使用
task_id 主动轮询“查询任务状态”接口。3
保存输出
在保留期结束前下载已完成的文件。
10. 速率限制与并发
此限制适用于提交到
/api/generate/submit 的生成任务。LLM 接口目前不限速。
超出限制时,请求会被拒绝并返回 HTTP 429,不会进入队列。对大多数用户来说,这个额度已经足够。如果你持续遇到 429 错误,可以联系支持申请提高限制;我们会审慎处理审批。
11. 上线生产前
将 API Key 保存在服务器端,切勿在浏览器或移动端代码中暴露。
按所选模型当前的 schema 校验输入。
显式处理
401、402、429 和临时性服务器故障。每次重试提交都可能产生新的计费任务;重新提交前,先确认原请求是否已创建任务。
生成的媒体是临时的。请及时下载结果,并遵守账户和 API 文档中说明的保留策略。
12. 借助 AI 助手构建
可以在 Claude Code、Codex 和 Cursor 等编程 Agent 中使用 PoYo。最快的方式无需配置 MCP,参见快速入门。当助手需要实时的模型 schema、账户信息和执行工具时,连接 PoYo MCP:Claude
Cursor
Codex
VS Code
13. 支持
使用 PoYo 控制台中的支持入口,可以最快获得结合你账户情况的帮助。推荐的支持渠道可直接在控制台左下角菜单中找到。开发者支持
Discord(最快)
私密的一对一频道。你的数据和对话保持机密。响应更快、更专业。