参考
正文API 参考
PopNow API 的所有接口一页看完，并附完整 OpenAPI 契约的链接。
完整、机器可读的契约是 openapi.yaml（OpenAPI 3.1）。可以导入 Postman、Insomnia 或代码生成器，也可以直接交给 AI 智能体。本页是给人看的总览图。
- Base URL：
https://api.popnow.ai/api/v1（OpenAI 兼容路由：https://api.popnow.ai/v1） - **鉴权：**每个请求都带
Authorization: Bearer sk-popnow-… - 外壳：
{ "code", "msg", "data", "request_id" }；code: 200表示成功 - **金额：**整数积分（
credits、maxCredits…），同时给出等额的美元字符串；1 积分 = $0.01
任务
| 方法与路径 | 作用 | 页面 |
|---|---|---|
POST /jobs/createTask | 创建生成任务（可选 ?wait=，最多 60 秒） | 任务 |
GET /jobs/recordInfo?taskId= | 读取任务状态和结果 | 任务 |
GET /jobs | 列出这个密钥的任务 | 任务 |
POST /jobs/quote | 不运行，只报价 | 积分与计费 |
POST /jobs/retry | 用失败或过期的任务新建一个任务 | 任务 |
POST /jobs/purge | 删除已结束任务的内容 | 任务 |
模型
文件与素材
| 方法与路径 | 作用 | 页面 |
|---|---|---|
POST /common/upload-url | 直传上传的票据 | 上传与下载 |
POST /files/{fileId}/commit | 完成上传并拿到 popnow:// URI | 上传与下载 |
POST /files/import | 从链接导入 LoRA 文件 | 素材库 |
POST /common/download-url | 为任务产物生成新的签名链接 | 上传与下载 |
GET /assets, POST /assets | 列出或保存素材 | 素材库 |
GET, PATCH, DELETE /assets/{assetId} | 读取、重命名或删除单个素材 | 素材库 |
GET /assets/entities | 你的角色 | 素材库 |
GET /assets/usage | 存储档位与用量 | 素材库 |
账户
OpenAI Videos 兼容（/v1）
| 方法与路径 | 作用 | 页面 |
|---|---|---|
POST /v1/videos | 创建视频任务 | OpenAI Videos |
GET /v1/videos/{id} | 读取它 | OpenAI Videos |
GET /v1/videos/{id}/content | 重定向到文件 | OpenAI Videos |
GET /v1/models | OpenAI 格式的模型列表 | OpenAI Videos |