返回 Puffer ProAPI 开放平台
OPENAI COMPATIBLE

几分钟接入 AI API

统一使用标准 Chat Completions 接口,按用途填写 auto-translate、auto-work 或 auto-fast,分别选择翻译、工作或速度模型。

STEP 1

设置接口地址

https://pufferpro.com/gateway/v1

STEP 2

发送请求

curl https://pufferpro.com/gateway/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto-work",
    "messages": [{"role": "user", "content": "你好"}],
    "max_tokens": 6000,
    "stream": false
  }'

模型与倍率

扣除额度=(输入+输出 Token)× 模型倍率。

模型名称用途倍率
auto-translate翻译模型0.8 倍
auto-work工作模型3 倍
auto-fast速度模型1 倍

每周共享 400,000 Token;文档翻译每日另赠 10,000 Token,从首次使用起 24 小时后恢复(本地时间)。先用每日额度,再用每周额度;是否使用充值额度由账户设置控制。

查看模型路由说明

翻译模型和速度模型:Qwen 3.8 → GPT-OSS-120B;工作模型:GPT-OSS-120B → Qwen 3.8。三个入口使用 /chat/completions,按对应模型池顺序选路。独立 auto 已停用;工作模型不保证每次响应最快。三个入口仅支持文本,目前不支持 /responses。OpenRouter 仍为明确声明公开非敏感内容后的最后备用,auto-fast 仅使用 Super 备用;其他两个入口可使用 Super → Ultra → Lightning。

查看我的剩余额度

公开内容的免费上游备用路由

先使用原有自动路由,仅在其他接口均不可用,且明确确认全部请求内容已公开且不含敏感信息时,才使用 OpenRouter 的 Nemotron Super → Ultra → Lightning 免费端作为最后备用。选择上述三个模型入口之一,本平台收费不变。

个人信息、密码、客户资料、机密文件,以及包含上述内容的历史消息、系统提示和工具返回,都不能启用此选项。未确认或标记为敏感的请求不会发送到这三个免费端,但仍会按原有路由发送至其他上游服务,不等同于本地处理或零留存。免费端可能记录请求,详情请查看下方数据说明。

在文档翻译或在线测试中勾选公开内容确认;第三方工具需在请求正文中加入下列字段。没有附加字段支持的工具继续使用原有路由,请勿把该声明自动套用到所有用户或对话。

"metadata": { "puffer_content_policy": "public_non_sensitive" }

不启用时请省略该字段,或设置 puffer_content_policy 为 sensitive。免费端数据说明

网页翻译

沉浸式翻译填写完整接口地址 https://pufferpro.com/gateway/v1/chat/completions,模型填写 auto-translate。按实际输入与输出 Token 合计扣除额度。

curl https://pufferpro.com/gateway/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto-translate",
    "messages": [{"role": "user", "content": "Translate into Chinese: The weather is nice today."}],
    "max_tokens": 6000
  }'

流式输出

把 stream 设置为 true,服务会使用 SSE 逐段返回内容,最后发送 [DONE]。

curl https://pufferpro.com/gateway/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto-work",
    "messages": [{"role": "user", "content": "介绍一下你自己"}],
    "max_tokens": 6000,
    "stream": true
  }'

常见错误

HTTP 401

API Key 无效、停用或未提供

HTTP 429

当前账户 Token 额度不足,或请求过快

HTTP 502

上游模型暂时不可用

使用限制与安全

  • • 单次平台输入+输出安全预算最多 350,000 Token。输入采用保守估算,为输出留出空间;模型自身的上下文与输出限制仍然适用。
  • • 未填写输出预算时默认 6,000 Token。输出预算并不等于实际用量;实际消耗按输入+输出 Token 合计计算。
  • • 调用前不冻结或预扣额度,完成后按实际 Token 用量结算。文档每日额度优先,其次为每周共享额度;充值额度 需要用户开启相应设置。
  • • API Key 可在支持自定义 OpenAI 接口的 App 中使用,只在创建时完整显示一次。
  • • 不要把 Key 写进公开网页、代码仓库或截图。停用、归档或可用 Token 额度不足后将无法继续调用。
学习支持说明

学习计划:每周免费 400,000 Token

欢迎年满14周岁、愿意认真学习的人,不限于在校学生。无论是在校学习、工作后进修,还是退休后探索新知识,都欢迎使用学习计划。

注册账户后首次使用已接入的功能会自动启用学习计划,优先使用每七天(从首次使用开始计时,按你的本地时间显示到分钟)400,000 Token 免费学习额度,无需手动启用或先充值。这是服务使用额度,不是现金;同一账户的所有关联 API 密钥共享一份额度。可用于已接入账户统一计费的网站功能与支持的 API 应用。

额度何时恢复?

每个周期为七天(168 小时),从服务器确认启用或重置时开始计算。未用额度不累积到下一期,修改手机或电脑时间不会提前恢复。已用和剩余额度、恢复时间及可用重置机会,均可在“使用情况”查看。

需要额外帮助时怎么办?

如果翻译课程论文、阅读外文教材或准备学习报告等任务尚未完成,额度却不够用了,可以通过官网提供的 QQ 客服联系方式说明学习需求,申请额外额度、充值卡或重置卡。是否发放及具体金额根据实际情况确定。

充值卡和重置卡有什么区别?

充值卡和重置卡仅用于提供额外学习支持,不支持额外购买。

需要帮助时,可以通过 QQ 联系客服,按实际学习需求申请;是否发放及具体额度以发放结果为准。它们不是参加免费学习计划的前提。充值卡增加独立的充值额度,不会重新计算学习计划的七天周期。

重置卡代表一次已发放的额度恢复机会。获得后,在“使用情况”点击“重置限额”并确认,即可恢复相应额度,同时重新开始七天倒计时;这里无需输入卡密。

免费额度和充值额度分开管理

按实际输入+输出 Token 合计扣除额度。文档翻译先使用每日 10,000 Token,再使用每周共享的 400,000 Token;每日额度从首次使用文档翻译起 24 小时后恢复(按你的本地时间,精确到分钟)。充值额度 的使用默认关闭,开启后仅扣除免费额度不足的部分。重置学习额度不会改变充值额度。

个人获得的额度、既有周期、重置机会和恢复时间,以登录后的“我的账户 → 使用情况”为准。

查看使用情况给每一位愿意学习的你文字版服务说明