Integração por API

Base URL

https://ai.episy.com.br/v1

Autenticação

Authorization: Bearer eps_live_SUA_CHAVE

Consultar conta

GET /v1/me

Agente de texto

POST /v1/text
Content-Type: application/json

{
  "prompt": "Crie 3 legendas para um post sobre inovação"
}

Gerar imagem

POST /v1/images/generations
Content-Type: application/json

{
  "prompt": "Post editorial para uma campanha de lançamento",
  "size": "1024x1536",
  "quality": "medium",
  "style": "authentic"
}

Retorna HTTP 202 e job_id. A Beta 0.4 recebe style opcional: authentic (padrão), editorial, product, institutional ou retail. O agente planeja o visual e a legenda em uma única etapa antes da imagem. Não há webhooks ainda.

Editar imagem existente

POST /v1/images/edits
Content-Type: application/json

{
  "source_job_id": 123,
  "prompt": "Troque somente a cor do fundo"
}

A imagem precisa pertencer à mesma conta e já estar concluída.

Legenda e direção de arte (Beta 0.4)

O campo caption de GET /v1/jobs/123 retorna a legenda assim que o modelo de texto terminar. Enquanto a arte ainda estiver sendo criada, status continuará como processing. Para novas gerações, o worker prepara a legenda e planeja a composição em uma chamada de texto. O resultado style informa o preset aplicado.

Consultar processamento

GET /v1/jobs/123

Quando status=completed, a resposta inclui um link temporário para a imagem. Esse link expira em 1 hora, podendo ser renovado com uma nova consulta ao job.

Limites e erros

30 solicitações/minuto por chave. Os limites diários são configurados pelo administrador. Retornos típicos: 401 (chave inválida), 422 (validação), 429 (limite), 503 (IA indisponível).