Popcraft API
汇集业界领先的 AI 模型，统一接入端点。
在你的产品中直接实现图像、视频、音频和数字人生成。Popcraft 处理排队、公平性、重试和计费——你只需发送一个提示词，即可获得结果。
面向企业组织开放 · 仅对成功生成的任务收费
# 发送一个提示词 —— 立即返回任务 ID
POST /v1/images/generations
{
"model": "nano-banana-2",
"prompt": "a tiny origami fox on a desk, soft morning light"
}
202 Accepted
{ "id": "job_9f2c1a", "status": "queued", "credits_reserved": 6 }图像
支持文本转图像及参考图引导生成，提供生产级分辨率，从快速草图到旗舰级质量均可实现。
视频
电影级文本转视频和图像转视频，支持明确的时长和分辨率 —— 按秒计费，报价透明。
音频
语音、音效和音乐。时长明确，因此在渲染出第一帧之前，信用额度扣除即已确定。
头像
通过音频或文本转语音驱动静态肖像，生成数字人说话视频 —— 一次调用，一段剪辑。
为生产环境而生
棘手的难题，早已迎刃而解。
生成过程缓慢、突发性强，且一旦出错代价高昂。本平台经过精心设计，确保一个租户的流量洪峰绝不会延迟另一个租户的单个任务。
内置泄露检测
系统会监控每个 API 密钥的调用量、频率峰值以及来自陌生国家的访问。任何可疑行为都会立即向所有者发出警报——因此，密钥泄露可以在几分钟内被发现，而不会等到账单结算时才察觉。
服务商限制，由我们承担
按类型划分的并发上限和按模型划分的速率预算，可自动确保您的使用量保持在服务商的限制范围内。背压处理采用清晰的 429 状态码，绝不会静默丢弃请求。
默认持久化
每个任务在被接收的瞬间即已持久化。部署、重启和实例故障绝不会导致任务丢失或重复计费。
从第一字节开始即实现异步
提交请求后，系统会在毫秒内返回任务 ID。您可以轮询状态，或者通过 Webhook 在任务就绪时接收推送结果。
签名 Webhook
终端事件会通过 HMAC 签名进行交付，并在失败时自动重试——因此，你完全可以跳过轮询，且绝不会错过任何结果。
实时模型目录
可在运行时查询可用模型及其功能、限制和积分价格。新模型上线时，您无需更改任何代码。
方案
从默认起步，随企业扩展。
没有复杂的层级迷宫。每个组织都从相同的合理默认配置开始，仅为实际生成的内容付费。当你需要更高的吞吐量时，企业版会将每个限制转化为我们与你共同设定的数值 —— 并优先保障并发能力。
协商空间
并发数由您决定。
默认数值只是底线，而非上限。在企业版中，每一项指标——包括并发任务数、调用频率、队列深度——均可由您设定并应用于整个组织。无需更改代码，也无需您额外生成新密钥。
| 维度 | 默认 | 企业版 |
|---|---|---|
| 图像任务处理中 | 10 个并发 | 联系我们以提高 |
| 视频任务处理中 | 4 个并发 | 联系我们以提高 |
| 音频任务处理中 | 6 个并发 | 联系我们以提高 |
| 头像任务处理中 | 2 个并发 | 联系我们以提高 |
| 请求数 / 分钟 | 60 | 联系我们以提高 |
| 队列深度 | 每种类型 50 个等待 | 联系我们以提高 |
| 单模型容量 | 共享池 | 联系我们获取专属服务 |
| 月度额度上限 | 由您设置 | 联系我们以提高 |
这些是实时生效的控制项，会在您的方案变更时按组织应用。提高吞吐量只需沟通即可，无需进行迁移。
支出与安全
所有者掌控一切。
将密钥交给开发者并不意味着交出预算。所有者可以设置支出上限，监控每一笔积分消耗，并随时关闭任何异常操作——无需提交工单。
设置支出上限
您可以为整个组织设置月度支出上限，并为每个密钥设定积分限额。两者均在提交时强制执行——超额请求在扣除任何积分前就会被拒绝。
尽早发现滥用行为
系统会监控每个密钥的调用量、频率峰值以及来自陌生国家的请求。一旦密钥出现泄露迹象，所有者会立即收到电子邮件和控制台内的提醒——只需一键即可撤销。
拒绝意外账单
失败、取消和超时的任务绝不会计费。配合支出上限和预警功能，泄露的密钥绝不会产生您未授权的账单。
账单
你为结果买单，而非为尝试付费。
积分在提交时预留，仅在任务完成时扣除。失败、取消和超时的任务不会产生任何费用——因此您根本无需担心退款问题。
报价透明，即时可见：每项请求在运行前都会根据实时目录进行定价，且每次读取状态时都会计算预计剩余额度，让您随时掌握可支配的预算。
采购部门常问的问题。
使用量以积分计量，并从您组织的月度周期中扣除——采用共享余额，而非为每位开发者单独设立钱包。每项请求均根据实时目录预先定价，且仅在任务完成时扣费。失败、取消及超时的任务不收取任何费用。
是的，分为两个层级：每个周期的组织上限和每个密钥的积分限额，因此单一集成不会耗尽预算。两者均在提交时强制执行——超限请求在扣除积分前即会被拒绝。所有者可控制这两项设置。
控制台显示按 API 密钥和团队成员划分的实时使用情况，并提供近期的任务与费用账单。您可以导出按任务或模型分类的 CSV 报表，涵盖任意日期范围。企业版增加了按月开票及净额结算条款。
每种模型类型都有运行中上限、密钥上限及有界队列。公平调度程序会在各密钥间进行轮询，因此某个客户突发的 200 个任务绝不会挤占另一个客户的单个任务。额外的工作会进入队列而非失败——在企业版中，上限会提升至您的吞吐量水平。
请求受限于每个密钥和每个组织的速率桶。默认数值为基准；并发数、请求速率、队列深度及每个模型的容量均为按组织设置的覆盖项，我们会即时应用——无需重新部署，也无需生成新密钥。
您会收到带有背压机制的 429 错误——绝不会静默丢弃。已被接受的任务会继续在队列中处理；您可以调整新提交的频率，或要求我们提高上限。
异步处理。提交请求后，系统会在毫秒内返回任务 ID。随后，您可以轮询生成端点，或让已签名的 Webhook 在结果就绪时立即推送给您。
终端事件带有 HMAC 签名，您可以根据组织的密钥进行验证，且在失败时会重试。因此，您可以完全跳过轮询，且绝不会错过任何结果。
内置的滥用检测功能会监控每个密钥的容量、速率峰值以及来自陌生国家的活动，并在发现异常时立即通过电子邮件和控制台向您的团队发出警报。您可以一键撤销权限——且消费上限意味着即使在您做出反应之前，影响范围也已受到限制。
可以。您可以授予成员具有“自我范围”的控制台访问权限——他们仅能管理自己的密钥并查看自己的使用情况，无法查看组织账单或其他成员的密钥。所有者和管理员则拥有全部权限。
API 按组织启用。您的客户经理会开启该功能并设置限额；此后，所有者即可在控制台中自助管理密钥、文档、使用情况和账单。大多数团队在当天即可调用生产模型。
入门指南
访问权限按组织授予。
API 仅向企业组织开放。一旦您的组织获得启用，所有者和管理员即可通过控制台自助处理一切事务。
01
获取启用
您的客户经理将为您的组织启用 API 访问权限，并设置您的专属额度池。
02
生成密钥，阅读文档
在控制台中为您的开发者创建作用域 API 密钥，并阅读包含复制粘贴示例的完整交互式参考文档。
03
发布上线
提交、轮询并渲染。当您的产品生成内容时，您可以在控制台中实时查看使用量和账单更新。