图片与视频生成 API

图片与视频,
一个 API 接入。

一个接口接入图片与视频模型,按模型和参数消耗积分,通过异步任务跟踪生成进度。

99.9%
近 30 天可用率
312ms
平均首字节
31款
可用媒体模型

Nano Banana 2

主推

第二代绘图模型&4K

2 - 3
积分 / 张
文生图 / 图生图

Nano Banana Pro

PRO

精准中文理解输出&4K

2 - 4
积分 / 张
文生图 / 图生图

GPT Image 2

文生图 / 图生图

1 - 3
积分 / 张
文生图 / 图生图

给 AI 一个链接,直接生成素材

让 Codex 等 AI 工具生成图片和视频、上传本地参考文件并保存结果,无需先安装 skill 或连接 MCP。

请读取 /openapi.md,按其中流程完成任务:[描述希望生成的图片或视频]。优先复用已保存的 PixZoo 凭据;没有凭据时发起网页登录授权,向我显示授权链接和授权码。不要输出密钥,不要在生成提交结果未知时自动重发,并将原始结果保存到本地。

需要网络和 Python 3.9+。首次使用登录并确认工具授权,凭据保存在工具环境中并自动续期;仍支持开发者 API Key。

模块一 · 价目表

按积分计费,没有 API 月费

按任务选择模型和参数。支持能力和定价规则以当前模型目录为准。

  • GPT Image 2
    gpt-image-2

    文生图 / 图生图

    1 - 3积分 / 张
    文生图 / 图生图
  • GPT Image 2.5 Flare 加速NEW
    gpt-image-2.5-flare

    速度优先 · 日常出图与快速原型

    1 - 100积分 / 张
    文生图 / 图生图画质选项
  • GPT Image 2.5 Sunburst 加速PRO
    gpt-image-2.5-sunburst

    编辑精度优先 · 商品图与创意制作

    1 - 100积分 / 张
    文生图 / 图生图画质选项
  • GPT Image 2.5 FlareNEW
    gpt-image-2.5-flare-lite

    图片生成与编辑 · 1K / 2K / 4K · 最多 16 张参考图

    2 - 3积分 / 张
    文生图 / 图生图
  • GPT Image 2.5 SunburstNEW
    gpt-image-2.5-sunburst-lite

    图片生成与编辑 · 1K / 2K / 4K · 最多 16 张参考图

    2 - 3积分 / 张
    文生图 / 图生图
  • Z Image TurboNEW
    z-image-turbo

    快速文生图 · 低成本创作

    1积分 / 张
    文生图
  • Seedream 5.0NEW
    seedream-5.0

    字节跳动图片生成与编辑模型

    2积分 / 张
    文生图 / 图生图
  • Seedream 5.0 FlashNEW
    seedream-5.0-flash

    文生图与多图编辑 · 最多 10 张参考图

    2 - 3积分 / 张
    文生图 / 图生图
  • Seedream 5.0 ProPRO
    seedream-5.0-pro

    图片生成与编辑 · 1K / 2K · 最多 10 张参考图

    4积分 / 张
    文生图 / 图生图
  • Wan2.5 文生图
    wan2.5-text-to-image

    阿里通义万相文生图模型

    2积分 / 张
    文生图
  • Qwen Image
    qwen-image-edit-plus

    阿里通义千问图片编辑模型

    2积分 / 张
    图生图
  • Nano Banana 2热门
    nano-banana-2

    第二代绘图模型&4K

    2 - 3积分 / 张
    文生图 / 图生图联网搜索
  • Nano Banana 2.1 加速热门NEW
    nano-banana-2.1

    图片生成与编辑 · 1K / 2K / 4K · 最多 14 张参考图

    4 - 5积分 / 张
    文生图 / 图生图联网搜索
  • Nano Banana 2.1热门NEW
    nano-banana-2.1-lite

    图片生成与编辑 · 1K / 2K / 4K · 最多 14 张参考图

    2 - 3积分 / 张
    文生图 / 图生图
  • Nano Banana Pro热门PRO
    nano-banana-pro

    精准中文理解输出&4K

    2 - 4积分 / 张
    文生图 / 图生图联网搜索
  • Seedance 2.0NEW
    seedance-2.0

    多参考融合 · 智能多帧 · 最高 4K

    12 - 125积分 / 秒
    文生视频 / 图生视频
  • Seedance 2.0 FastNEW
    seedance-2.0-fast

    快速出片 · 全能参考 · 最高 720p

    7 - 75积分 / 秒
    文生视频 / 图生视频
  • Seedance 2.0 MiniNEW
    seedance-2.0-mini

    轻量低成本 · 快速预览

    2 - 20积分 / 秒
    文生视频 / 图生视频
  • Seedance 2.5NEW
    seedance-2.5

    多图参考 · 智能多帧 · 最长 30 秒

    18 - 200积分 / 秒
    文生视频 / 图生视频
  • Veo3.1 FastNEW
    veo3.1-fast-official

    快速生成 · 最高 4K

    15 - 120积分 / 秒
    文生视频 / 图生视频
  • Veo3.1 QualityNEW
    veo3.1-quality-official

    电影感画面 · 最高 4K

    55 - 440积分 / 秒
    文生视频 / 图生视频
  • Veo3.1 Fast LiteNEW
    veo3.1-fast

    快速生成 · 最高 4K

    15 - 120积分 / 秒
    文生视频 / 图生视频
  • Veo3.1 Quality LiteNEW
    veo3.1-quality

    电影感画面 · 最高 4K

    55 - 440积分 / 秒
    文生视频 / 图生视频
  • Kling V3NEW
    kling-v3

    首尾帧控制 · 最高 4K · 按秒计费

    12 - 75积分 / 秒
    文生视频 / 图生视频
  • Wan 3.0 VideoNEW
    wan3.0-video

    多图参考 / 首尾帧 · 最高 1080p · 最长 30 秒

    2 - 27积分 / 秒
    文生视频 / 图生视频
  • Grok Imagine ImageNEW
    grok-imagine-image

    文生图 / 多图编辑 · 最多 3 张参考图

    2积分 / 张
    文生图 / 图生图画质选项
  • Grok Imagine VideoNEW
    grok-imagine-video

    文生视频 / 多图参考 · 1–15 秒

    2 - 11积分 / 秒
    文生视频 / 图生视频
  • Gemini Omni FlashNEW
    gemini-omni-flash

    多模态参考 · 视频编辑

    16 - 96积分 / 秒
    文生视频 / 图生视频
  • GPT Image 2 加速NEW
    gpt-image-2-official

    OpenAI 图像模型 2.0

    1 - 45积分 / 张
    文生图 / 图生图画质选项
  • Nano Banana 2 加速热门
    nano-banana-2-official

    第二代绘图模型&4K

    4 - 5积分 / 张
    文生图 / 图生图联网搜索
  • Nano Banana Pro 加速热门PRO
    nano-banana-pro-official

    精准中文理解输出&4K

    3 - 6积分 / 张
    文生图 / 图生图联网搜索
以任务状态为准。客户端网络超时不代表生成失败,请使用已保存的任务 ID 继续查询。实际扣费以服务端计算为准
模块二 · 接口文档

接口使用说明

generate 只提交一次,保存站点任务 ID 后每 10 秒 query 查询。本地参考文件先上传;请求超时不应自动重新生成。

调用流程

  1. 1.调用 /api/ai/generate/ 一次,保存 data.id 作为站点任务 ID
  2. 2.每 10 秒查询已保存的任务 ID,直到 success、failed 或 canceled;超时不重新提交
  3. 3.从 outputImages 获取并下载原始媒体,图片和视频任务均使用此字段

鉴权

API Key 仅允许上传、生成(含图片处理)和查询本人任务;不能充值、修改账户设置或管理密钥。生成会消耗账户已有积分。请求头格式如下:

Authorization: Bearer sk-<your-api-key>
Content-Type: application/json

可用模型

model名称支持场景
gpt-image-2GPT Image 2文生图 / 图生图
gpt-image-2.5-flareGPT Image 2.5 Flare 加速文生图 / 图生图
gpt-image-2.5-sunburstGPT Image 2.5 Sunburst 加速文生图 / 图生图
gpt-image-2.5-flare-liteGPT Image 2.5 Flare文生图 / 图生图
gpt-image-2.5-sunburst-liteGPT Image 2.5 Sunburst文生图 / 图生图
z-image-turboZ Image Turbo文生图
seedream-5.0Seedream 5.0文生图 / 图生图
seedream-5.0-flashSeedream 5.0 Flash文生图 / 图生图
seedream-5.0-proSeedream 5.0 Pro文生图 / 图生图
wan2.5-text-to-imageWan2.5 文生图文生图
qwen-image-edit-plusQwen Image图生图
nano-banana-2Nano Banana 2文生图 / 图生图
nano-banana-2.1Nano Banana 2.1 加速文生图 / 图生图
nano-banana-2.1-liteNano Banana 2.1文生图 / 图生图
nano-banana-proNano Banana Pro文生图 / 图生图
seedance-2.0Seedance 2.0文生视频 / 图生视频
seedance-2.0-fastSeedance 2.0 Fast文生视频 / 图生视频
seedance-2.0-miniSeedance 2.0 Mini文生视频 / 图生视频
seedance-2.5Seedance 2.5文生视频 / 图生视频
veo3.1-fast-officialVeo3.1 Fast文生视频 / 图生视频
veo3.1-quality-officialVeo3.1 Quality文生视频 / 图生视频
veo3.1-fastVeo3.1 Fast Lite文生视频 / 图生视频
veo3.1-qualityVeo3.1 Quality Lite文生视频 / 图生视频
kling-v3Kling V3文生视频 / 图生视频
wan3.0-videoWan 3.0 Video文生视频 / 图生视频
grok-imagine-imageGrok Imagine Image文生图 / 图生图
grok-imagine-videoGrok Imagine Video文生视频 / 图生视频
gemini-omni-flashGemini Omni Flash文生视频 / 图生视频
gpt-image-2-officialGPT Image 2 加速文生图 / 图生图
nano-banana-2-officialNano Banana 2 加速文生图 / 图生图
nano-banana-pro-officialNano Banana Pro 加速文生图 / 图生图

图片、视频模型及完整能力以 /openapi/models.json 为准

POST/api/ai/generate/提交一个图片或视频任务。保存 data.id 后查询结果;提交不具备幂等性。

请求参数

字段类型必填说明
mediaTypestring✓image 或 video
modelstring✓模型标识符,见上方可用模型列表
promptstring✓生成提示词
scenestring选择模型支持的 text-to-image、image-to-image、text-to-video 或 image-to-video 场景
options.aspectRatiostring宽高比,如 "1:1"、"16:9"、"9:16"
options.resolutionstring分辨率档位,如 "1K"、"2K"、"4K"
options.referenceImages{url, role?}[]有序参考对象数组,每项包含 url 和可选 role:firstFrame、lastFrame 或 reference

请求示例(Python / Node.js)

import json, os
from urllib.request import Request, build_opener, HTTPRedirectHandler

class NoRedirect(HTTPRedirectHandler):
    def redirect_request(self, *args):
        return None

body = {
  "schemaVersion": 1,
  "mediaType": "image",
  "model": "nano-banana-2",
  "prompt": "A red panda reading a book, soft natural light",
  "scene": "text-to-image",
  "options": {
    "aspectRatio": "1:1"
  }
}
request = Request(
    "https://pixzoo.ai/api/ai/generate/",
    data=json.dumps(body).encode(),
    headers={"Authorization": "Bearer " + os.environ["PIXZOO_API_KEY"],
             "Content-Type": "application/json"},
)
# One attempt. Never retry an ambiguous generation submission.
with build_opener(NoRedirect()).open(request, timeout=180) as response:
    result = json.load(response)
if result.get("code") != 0:
    raise RuntimeError("PixZoo API rejected the request")
from pathlib import Path
Path("pixzoo-task-id.txt").write_text(result["data"]["id"])
print("Task ID saved; query the same ID for results")
# Full resumable upload/wait/download workflow: https://pixzoo.ai/openapi.md

响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "3f2a1b4c-...",
    "status": "queuing"
  }
}

视频请求示例

{
  "schemaVersion": 1,
  "mediaType": "video",
  "model": "seedance-2.0",
  "prompt": "A red panda reading a book, slow camera dolly, soft natural light",
  "scene": "text-to-video",
  "options": {
    "aspectRatio": "16:9"
  }
}

支持场景、参考素材数量、时长与分辨率以当前模型目录为准。先上传参考素材,再传 canonical referenceImages/referenceVideos/referenceAudios。

上传本地参考素材

申请与确认上传均支持 Authorization: Bearer API_KEY 和 application/json;文件字节直接 PUT 到返回的存储地址。现有可访问 URL 可直接用于生成,无需重复上传。

1. 申请文件直传

POST/api/storage/presign/
字段类型必填说明
filenamestring✓原始文件名,1–255 个字符。
contentTypestring✓实际 MIME 类型,须在下方支持列表中。
sizeinteger✓原始文件实际字节数,正整数;不是 MB。
purpose"media"使用 media,普通参考上传不创建素材库记录。

请求 JSON

{
  "filename": "reference.png",
  "contentType": "image/png",
  "size": 1024,
  "purpose": "media"
}

响应示例(域名、签名、ID 和时间仅为占位)

{
  "code": 0,
  "message": "ok",
  "data": {
    "uploadId": "11111111-1111-4111-8111-111111111111",
    "uploadUrl": "https://storage.example.test/pending/reference.png?signature=example",
    "headers": {
      "Content-Type": "image/png"
    },
    "expiresAt": "2030-01-01T00:05:00.000Z"
  }
}

2. PUT 原始文件到 uploadUrl

以文件原始字节作为整个请求体,使用返回的 data.headers;不要发送 JSON、multipart、Cookie 或 PixZoo API Key。检查 PUT 的 HTTP 状态后再确认上传。

3. 确认上传并取得最终 URL

POST/api/storage/complete/
字段类型必填说明
uploadIdUUID✓申请直传返回的 uploadId,UUID;必须由同一用户确认。

请求 JSON

{
  "uploadId": "11111111-1111-4111-8111-111111111111"
}

响应示例(域名、签名、ID 和时间仅为占位)

{
  "code": 0,
  "message": "ok",
  "data": {
    "uploadId": "11111111-1111-4111-8111-111111111111",
    "key": "uploads/example/reference.png",
    "url": "https://media.example.test/uploads/reference.png",
    "filename": "reference.png",
    "size": 1024,
    "materialId": null
  }
}

签名 URL 有效期为 5 分钟,确认窗口为 1 小时。确认接口对同一个 uploadId 幂等;响应丢失时只重试确认。完成后使用 data.url 作为参考素材,不要使用临时 uploadUrl。模型可能有更严格的参考素材限制。

支持类型与单文件上限

MIME 类型最大大小
image/jpeg25 MiB
image/png25 MiB
image/webp25 MiB
image/gif25 MiB
image/svg+xml5 MiB
video/mp4100 MiB
video/webm100 MiB
video/quicktime100 MiB
audio/mpeg25 MiB
audio/wav25 MiB
audio/x-wav25 MiB
audio/mp425 MiB
audio/aac25 MiB
audio/ogg25 MiB
查看操作指南
POST/api/ai/query/每 10 秒查询当前用户的站点任务 ID。success、failed、canceled 为终态;查询超时不等于任务失败。

请求参数

字段类型必填说明
taskIdstring✓由 /api/ai/generate/ 返回的任务 ID

请求示例(Python / Node.js)

import json, os
from urllib.request import Request, build_opener, HTTPRedirectHandler

class NoRedirect(HTTPRedirectHandler):
    def redirect_request(self, *args):
        return None

body = {
  "taskId": "replace-with-site-task-id"
}
request = Request(
    "https://pixzoo.ai/api/ai/query/",
    data=json.dumps(body).encode(),
    headers={"Authorization": "Bearer " + os.environ["PIXZOO_API_KEY"],
             "Content-Type": "application/json"},
)
# One attempt. Never retry an ambiguous generation submission.
with build_opener(NoRedirect()).open(request, timeout=180) as response:
    result = json.load(response)
if result.get("code") != 0:
    raise RuntimeError("PixZoo API rejected the request")
print("Task status:", result["data"]["status"])
# Full resumable upload/wait/download workflow: https://pixzoo.ai/openapi.md

处理中响应

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "3f2a1b4c-...",
    "status": "processing",
    "outputImages": null
  }
}

成功响应

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "3f2a1b4c-...",
    "status": "success",
    "outputImages": [
      "https://gempix.cn/outputs/xxx.png"
    ]
  }
}

任务状态说明

status说明
queuing已入队,等待处理
pending已提交至 AI 提供商,等待响应
processingAI 提供商处理中
success生成成功;outputImages 包含原始图片或视频 URL
failed生成失败,已自动退还消耗的积分
canceled任务已取消,停止查询

错误响应

同时检查 HTTP 状态与 JSON code。HTTP 200 且 code=-1 仍为业务失败。鉴权失败或余额不足时停止,不自动重新提交生成。

{
  "code": -1,
  "message": "insufficient credits"
}
  • no authAPI Key 无效或未传入
  • insufficient credits积分不足
  • task not found任务不存在
  • no permission无权访问该任务(任务属于其他用户)
模块三 · 你的密钥

在当前页面创建 API Key

直接在当前页面创建并复制密钥。每个账号最多 10 个 Key,可分别用于不同项目。

正在加载 API Key…

已授权的 AI 工具

工具授权与开发者 API Key 分开管理。撤销后立即停止访问和续期。

正在加载工具授权…

模块四 · 常见问题

开发者常见问题

了解鉴权、本地素材上传、计费和任务恢复。

准备好了吗?
开始调用 API。

选择模型,登录授权 AI 工具,开始生成图片或视频。

图片与视频生成 · 异步任务 · 原始结果