Referênciav1.0.0 Estável

PavoAI Pro API

Integre capacidades de geração de imagens com IA de alto desempenho. Esta documentação fornece referência completa da API, guias de integração e exemplos de código para ajudar desenvolvedores a criar rapidamente aplicações de geração de imagens com IA.

https://pavoai.pro

Início rápido

Conclua sua primeira chamada à API em apenas duas etapas: envie uma tarefa de geração e, em seguida, consulte o status.

Enviar tarefa

Envie uma requisição POST para o endpoint de geração para obter um ID de tarefa.

Consultar status

Use o ID de tarefa para verificar o progresso até obter a URL da imagem.

Autenticação

Observação: mantenha sua chave de API segura e não a exponha em código do lado do cliente.

Cabeçalho HTTP

Authorization: Bearer {YOUR_API_KEY}

POST

https://pavoai.pro/api/generate

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

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

Parâmetros do corpo

Nome do parâmetro	Tipo	Obrigatório	Descrição
`prompt`	string	Sim	Text prompt for generation (max 1000 characters).
`aspect_ratio`	string	Sim	Aspect ratio for the generated image. Allowed values: 1:1, 4:3, 3:4, 16:9, 9:16.

Resposta (JSON)

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

GET

https://pavoai.pro/api/status

Consulta o status de execução e os resultados de uma tarefa.

Parâmetros de consulta

Nome do parâmetro	Obrigatório	Descrição
`task_id`	Sim	O ID retornado ao enviar a tarefa.

Exemplo de resposta

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

Cobrança

Custo por geração

$0.02 / requisição

Tarefas com falha não são cobradas.

Tratamento de erros

401 Invalid API keyChave de API inválida
402 Payment RequiredSaldo insuficiente
429 Too Many RequestsMuitas requisições

Sobre o PavoAI Pro

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

PavoAI Pro — fluxos de imagem e vídeo no mesmo espaço

O PavoAI Pro oferece um espaço de criação no navegador para modelos de imagem e vídeo compatíveis. O espaço de imagens usa GPT Image 2.5 por padrão e o espaço de vídeo usa Seedance 2.5.

Escolha o fluxo do projeto

Use o espaço de imagens para imagens estáticas e referências, o espaço de vídeo para texto para vídeo e imagem para vídeo, e as ferramentas compartilhadas para limpeza, som, voz, legendas e finalização.

O que o espaço oferece

Criação de imagens — Crie imagens estáticas, referências, visuais de produtos e conceitos no espaço de imagens.
Modelos de vídeo — Escolha o modelo conforme o plano, o movimento, o formato e a entrada.
Imagem para vídeo — Anime uma referência compatível no espaço de vídeo.
Ferramentas de edição — Continue com limpeza, aumento, legendas e ferramentas relacionadas.
Áudio e voz — Adicione som, isole voz, transcreva ou crie fala com as ferramentas disponíveis.
Acesso para desenvolvedores — Use API Keys e a documentação da API para integrações compatíveis.

Como usar

promptprompt – orientação em linguagem natural para a cena ou resultado visual.
sizeaspect_ratio – escolha uma forma de saída de imagem compatível.
seedmodel – escolha o fluxo de imagem ou vídeo compatível.

Gerar imagem Gerar vídeo