参考文档v1.0.0 稳定版本

PavoAI Pro API

集成高性能 AI 图像生成能力。本开发文档提供完整 API 参考、集成指南与代码示例，帮助开发者快速构建 AI 图像应用。

https://pavoai.pro

快速上手

仅需两个步骤即可完成你的第一次 API 调用：提交生成任务，然后轮询查询任务状态。

提交任务

向生成接口发送 POST 请求以获取 Task ID。

查询状态

使用 Task ID 检查进度，直到获取图片 URL。

身份验证

注意：请妥善保管 API Key，不要在客户端代码中暴露。

HTTP Header

Authorization: Bearer {YOUR_API_KEY}

POST

https://pavoai.pro/api/generate

创建一个新的图像生成任务。此接口为异步调用，将立即返回 task_id 与任务初始状态；请调用 /api/status 来获取最终生成的图片。

此接口会立即返回 task_id；请轮询 /api/status，直到任务状态为 SUCCESS 来获取图像 URL。

请求体参数

参数名称	类型	必填	描述
`prompt`	string	是	用于生成图像的文本提示（最多 1000 字符）。
`aspect_ratio`	string	是	生成图像的宽高比。可选值：1:1, 4:3, 3:4, 16:9, 9:16。

返回示例（JSON）

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://pavoai.pro/api/status

查询任务执行状态与生成结果。

查询参数

参数名称	必填	描述
`task_id`	是	提交任务时返回的任务 ID。

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

计费

每次生成费用

$0.02 / 次请求

失败任务不收费。

错误处理

401 未授权无效的 API Key
402 需要付款余额不足
429 请求过多触发速率限制

关于 PavoAI Pro

PavoAI Pro is an independent browser workspace for supported AI image, video, audio, speech, and finishing workflows.

PavoAI Pro — 在一个工作台中完成图片与视频创作

PavoAI Pro 提供统一的浏览器创作工作台，连接受支持的图片和视频模型。图片工作台默认使用 GPT Image 2.5，视频工作台默认使用 Seedance 2.5。

按项目选择工作流

图片工作台适合静帧和参考图，视频工作台适合文生视频和图生视频，共享工具可用于清理、声音、语音、字幕和后期处理。

工作台包含什么

图片创作 — 在图片工作台中制作静帧、参考图、产品视觉和概念图。
视频模型 — 根据镜头、运动、画幅和输入选择合适的视频模型。
图生视频流程 — 使用受支持的图片输入，在视频工作台中让参考图动起来。
编辑工具 — 继续使用图片和视频清理、放大、字幕及相关工具。
音频与语音 — 添加声音、分离人声、转录或使用可用工具生成语音。
开发者接入 — 使用 API Keys 和 API 文档接入受支持的工作流。

使用方法

promptprompt — 描述场景或视觉结果的自然语言指令。
sizeaspect_ratio — 为任务选择受支持的图片输出画幅。
seedmodel — 选择受支持的图片或视频工作流。

生成图片生成视频