ReferênciaGPT Image 2.5 Estável

Guia de API do Studio TopviewAI Pro

Gerencie chaves de API e entenda as solicitações do Studio com sessão iniciada. O exemplo usa GPT Image 2.5; os outros modelos têm seus próprios formatos de solicitação.

https://topviewai.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

Estes endpoints do Studio exigem uma sessão iniciada e uma chave de API. Uma chave Bearer sozinha não é suficiente. Mantenha a chave privada.

Cabeçalho HTTP

Authorization: Bearer {YOUR_API_KEY}

POST

https://topviewai.pro/api/image/gpt-image-2-5/generate

Envie uma solicitação de imagem ao GPT Image 2.5. A resposta retorna um task_id; consulte o resultado no endpoint de status correspondente.

A solicitação é assíncrona: guarde task_id e consulte o status até SUCCESS ou um erro definitivo.

Parâmetros do corpo

Nome do parâmetro	Tipo	Obrigatório	Descrição
`prompt`	string	Sim	Descreva a imagem com 1 a 20.000 caracteres.
`aspect_ratio`	string	Não	Proporção opcional; o padrão é auto. Exemplos: 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://topviewai.pro/api/image/gpt-image-2-5/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": "Um pôr do sol sobre as montanhas",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 4,
    "created_at": "2026-11-05 13:05:09",
    "error_message": null
  }
}

Cobrança

Exemplo de custo do GPT Image 2.5

4 créditos / imagem 1K

O custo varia conforme o modelo, a resolução e as configurações. Confira a estimativa do Studio e o consumo registrado na tarefa.

Tratamento de erros

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

Sobre o TopviewAI Pro

Um Studio para vídeo, imagens, edição, voz e áudio.

Escolha o modelo para cada tarefa

Use Seedance 2.5 para vídeo, GPT Image 2.5 para imagens e os demais modelos do Studio. Cada modelo mantém seu nome real.

Um saldo, custos por modelo

Escolha uma assinatura ou uma recarga avulsa por uso. Os créditos pagam os modelos e ferramentas que você utiliza.

Ferramentas de imagem Ferramentas de vídeo