Referencev1.0.0 Stable

PavoAI Pro API

Use the PavoAI Pro API to connect supported image and video generation workflows to your application. This documentation covers authentication, task submission, status polling, and error handling.

https://pavoai.pro

Quick Start

Complete your first API call in just two steps: submit a generation task, then poll for status.

Submit Task

Send a POST request to the generate endpoint to get a Task ID.

Query Status

Use the Task ID to check progress until you get the image URL.

Authentication

Note: Please keep your API Key secure and do not expose it in client-side code.

HTTP Header

Authorization: Bearer {YOUR_API_KEY}

POST

https://pavoai.pro/api/generate

Create a supported image generation task. This endpoint is asynchronous and returns a task_id plus initial status; call /api/status to retrieve the result.

This endpoint responds immediately with task_id. Poll /api/status until the status becomes SUCCESS to obtain image URLs.

Body Parameters

Parameter Name	Type	Required	Description
`prompt`	string	Yes	Text prompt for generation (max 1000 characters).
`aspect_ratio`	string	Yes	Aspect ratio for the generated image. Allowed values: 1:1, 4:3, 3:4, 16:9, 9:16.

Response (JSON)

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

GET

https://pavoai.pro/api/status

Query the execution status and results of a task.

Query Parameters

Parameter Name	Required	Description
`task_id`	Yes	The ID returned when submitting the task.

Response Example

{
  "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
  }
}

Billing

Cost per generation

$0.02 / request

Failed tasks are not charged.

Error Handling

401 Invalid API keyInvalid API Key
402 Payment RequiredInsufficient balance
429 Too Many RequestsRate limit triggered

About PavoAI Pro

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

PavoAI Pro — image and video workflows in one workspace

PavoAI Pro provides a shared browser workspace for supported image and video models. The image workspace defaults to GPT Image 2.5 and the video workspace defaults to Seedance 2.5.

Choose the workflow for the project

Use the image workspace for stills and references, the video workspace for text-to-video and image-to-video, and the shared tools for cleanup, sound, speech, captions, and finishing.

What the workspace covers

Image creation — Create stills, references, product visuals, and concepts in the image workspace.
Video models — Choose the video model that fits the shot, motion, format, and input.
Image-to-video workflows — Use supported image inputs to animate a reference in the video workspace.
Editing tools — Continue with image and video cleanup, upscale, captions, and related tools.
Audio and speech — Add sound, isolate voice, transcribe, or create speech with the available tools.
Developer access — Use API Keys and the API documentation for supported integrations.

How to use

promptprompt – natural-language direction for the scene or visual result.
sizeaspect_ratio – choose a supported image output shape for the task.
seedmodel – choose the supported image or video workflow for the request.

Generate Image Generate Video