图片与视频生成
本栏目只记录 PopGo 对外可用的图片与视频模型。所有示例都使用 PopGo 的统一 OpenAI 兼容入口；模型的实时可用状态、价格和已启用能力以模型与价格页为准。
接入前先确认
- 将客户端的 Base URL 设置为
https://api.popgo.site/v1。 - 使用
Authorization: Bearer YOUR_API_KEY认证。 - 在模型与价格页复制准确的公开模型 ID，替换示例中的
YOUR_MODEL。 - 先用文生图或短视频验证模型和 Key，再加入参考素材、高清规格或较长时长。
公开模型目录
| 类型 | 模型 |
|---|---|
| 图片 | gpt-image-2、gpt-image-2 4K |
| 图片 | nano-banana-1、nano-banana-2 |
| 图片 | grok-imagine-image、grok-imagine-image-quality |
| 视频 | grok-imagine-video、grok-imagine-video-1.5 |
| 视频 | kling-video-v3、kling-video-v3-omni、kling-video-v3-turbo |
| 视频 | seedance-2.5-B、seedance2.0-F-1080p、seedance2.5-A、seedance2.0-B、seedance2.0-fast-F-720p、seedance2.0-F-720p、seedance2.0-E-720p、seedance2.0-fast-B、seedance2.0-A、seedance-2.0-C |
同一行中的模型具有相近的协议和使用方式，但不代表规格完全相同。请进入对应模型页检查分辨率、时长、参考素材数量和计费维度。
端点速查
| 用途 | 方法 | PopGo 路径 |
|---|---|---|
| 文生图 | POST | /v1/images/generations |
| 图像编辑 | POST | /v1/images/edits |
| 视频任务提交 | POST | /v1/videos |
| 视频任务查询 | GET | /v1/videos/{task_id} |
| 视频内容下载 | GET | /v1/videos/{task_id}/content |
PopGo 对外统一使用 /v1/videos 创建和查询视频任务。客户端不需要知道实际渠道的内部创建路径、轮询路径或模型映射。
参考素材来源
参考素材不是所有模型都通用：
- 图片编辑通常使用
multipart/form-data上传image文件。 - 支持 URL 的视频模型要求 URL 是服务端可以直接访问的公网直链；需要登录、Cookie、签名临时权限或网盘落地页的链接通常不可用。
- 支持 Base64 的模型要求完整 Data URL，例如
data:image/png;base64,...。不能把不带 MIME 前缀的裸 Base64 当作 URL。 - 视频、音频和图片的支持情况、数量上限以及是否支持首尾帧，必须以对应模型页为准。
统一响应约定
图片接口返回 OpenAI Images 形式的 data 数组。视频接口先返回任务 ID，完成后再返回可下载地址。参考 视频任务流程 了解状态、进度和失败处理。
排查顺序
出现错误时依次确认：模型 ID 是否准确、请求路径是否正确、Key 是否有效、请求字段是否属于该模型、参考地址是否能被服务端访问、时长和分辨率是否在模型范围内，以及模型价格是否已配置。