PopNow API 是怎么运作的

API 能做什么、贯穿所有页面的五个概念，以及推荐的阅读顺序。

PopNow API 让你自己的软件也能用上 popnow.ai 上的图片、视频和音频模型。同样的模型、同样的价格、同样的积分——只是从点按钮变成了写代码调用。

能做什么

产出	例子
图片	文字生成图片、用一张或多张参考图改图、超分放大、抠图、图层拆分
视频	文字生成视频、图片生成视频、首尾帧视频、参考生视频、视频续写与编辑、对口型、数字人口播
音频	音乐、音效、文字转语音、给已有视频配音效、语音转文字

完整清单和每个模型的 ID、价格都在模型页。API 只覆盖图片、视频和音频生成，不包含聊天和文本模型。

贯穿始终的五个概念

模型 ID

每个能调用的东西都有一个 <出品方>/<型号>/<任务> 形式的 ID，例如 alibaba/wan-3.0/image-to-video 或 google/nano-banana-2.1/edit。每个请求都把它填在 model 字段里。图片编辑一律以 /edit 结尾。PopNow 自己做的工具（比如抠图）出品方写 popnow。

任务

生成要花几秒到几分钟，所以每个请求都会创建一个任务。你马上拿到 taskId，结果好了再去读。任务会经历 queued → running → 一个终态：succeeded、failed 或 expired。详见任务。

积分

API 用的是和网站同一份积分。基准价下 1 积分 = $0.01。任务被受理时，先冻结它可能的最高价格；完成后按实际金额扣费（不会超过冻结额），多余的退回。失败的任务不花钱。详见积分与计费。

幂等键

网络超时并不能告诉你服务器到底收没收到请求。每次创建任务都带上 Idempotency-Key 请求头，用同一个键重试时拿回的就是原来的任务，而不会再生成、再扣费一次。详见幂等。

Webhook

与其一遍遍查询任务，不如给它一个 callBackUrl。任务完成时，PopNow 会把完整结果发到这个地址，并带上签名，方便你确认消息确实来自我们。详见 Webhook。

一个请求长什么样

POST https://api.popnow.ai/api/v1/jobs/createTask
Authorization: Bearer sk-popnow-...
Idempotency-Key: 7d0c9a52-...

{ "model": "alibaba/wan-3.0/image-to-video",
  "input": { "image_url": "https://…/photo.jpg", "prompt": "The waves roll in slowly" },
  "callBackUrl": "https://your-app.example.com/hooks/popnow" }

所有响应都用同一个外壳：{ "code", "msg", "data", "request_id" }，code: 200 表示成功。