Referência · Erros

Erros da Photta API todos os tipos e o que fazer

Em uma frase

Toda falha da Photta API retorna o mesmo formato: um status, um `error.type`, uma mensagem e um `request_id`. Tente novamente 429 após o cabeçalho Retry-After e 5xx com backoff; corrija 400, 401 e 402 no seu próprio código.

Obter uma chave de APILer a documentação
  • Erros: 7 tipos de erro
  • Retry-After: Retry-After: 30s
  • Limites: 600 requisições/min

Todos os números nesta página vêm de a documentação da API da Photta · verificado

Tipos de erro

A lista completa publicada na documentação da API.

400invalid_request_error
The request is malformed or contains invalid parameters.
401authentication_error
The API key is missing, invalid, or expired.
402insufficient_credits_error
Your account does not have enough credits.
404not_found_error
The requested resource does not exist.
409conflict_error
The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error
Too many requests. Slow down and retry.Retry-After: 30
500api_error
An internal server error occurred. Retry later.

O formato de um erro

O mesmo envelope em cada endpoint, não importa o que deu errado.

{
  "error": {
    "type": "rate_limit_error",
    "message": "Rate limit exceeded."
  },
  "request_id": "req_xxxxxxxx"
}

Tratamento de falhas

  • Respeite o Retry-After

    Um 429 traz um header Retry-After. Aguarde essa quantidade de segundos e tente novamente com backoff exponencial — tentar imediatamente só empurra a próxima janela para mais longe.

  • Falhas reembolsam credits

    Uma geração que falha após ser aceita reembolsa seus credits automaticamente, para que uma nova tentativa não gere cobrança dupla.

  • Informe o id da requisição

    Toda resposta traz um `request_id`. Registre-o em log. É a forma mais rápida para o suporte encontrar uma falha específica entre milhares.

  • 409 é um sinal de fila

    Um conflito significa que o limite de lotes simultâneos do seu plano foi atingido. Faça polling do lote já em andamento até que ele seja concluído e só então envie novamente — não fique em loop esperando.

Perguntas sobre erros da API

Como é o corpo de um erro?

Um objeto `error` com um `type` e uma `message`, junto com o `request_id`. O tipo é estável e legível por máquina; a mensagem é para humanos e pode mudar.

Quais erros valem uma nova tentativa?

429 após aguardar os segundos do Retry-After, e 5xx com backoff exponencial. Um 400, 401 ou 402 falhará da mesma forma até que algo mude do seu lado.

O que significa um 402?

`insufficient_credits_error` — a conta não possui credits suficientes para a chamada, ou para a reserva completa em um lote. Nada é gerado e nada é cobrado.

Como reporto uma falha?

Envie o `request_id`, o endpoint e o horário. Essa trinca identifica a chamada exata; a imagem em si não é necessária para localizá-la.

Endpoints e referências

Todos os números nesta página vêm de a documentação da API da Photta · verificado

Experimente a API em cinco minutos

Gere uma chave de API do Photta, cole o snippet de cURL acima e você terá sua primeira imagem com modelo antes que o café termine de passar.

Criar uma conta e obter uma chave de APIAPI
  • 7 tipos de erro
  • Retry-After: 30s
  • 600 requisições/min