Gerar Efeito V2

Propósito

Gera um resultado com estilo de efeito de forma assíncrona. Você pode fornecer uma descrição em texto para orientar a geração do efeito e, opcionalmente, enviar uma imagem.

Método e Caminho

POST /public/v1/generate/effect/v2

Autenticação

Veja a página de Autenticação. O token Bearer é obrigatório.

Cabeçalhos Obrigatórios:

Authorization: Bearer {your_api_key}

Campos da Requisição

Nome do Campo	Tipo	Obrigatório	Descrição
description	string	Sim	Descrição do efeito
quality	string	Sim	Qualidade: standard, pro
frame	number	Sim	Frames: 4, 9, 16
image	file	Não	Imagem de referência opcional

Resposta

Resposta de Sucesso (200 OK):

{
  "job_id": "uuid-string"
}

Campo	Tipo	Descrição
job_id	string	Identificador único do job criado. Use Obter Status do Job para consultar o resultado

Regras de Erro / Validação

Situação	Status HTTP	Mensagem de Erro
Invalid image file	400	"Invalid image file"
Chave de API inválida	401	Invalid API key

Comportamento Assíncrono do Job

Este endpoint cria um job assíncrono. Ele retorna imediatamente um job_id, enquanto a geração real do efeito acontece em segundo plano.

Método de Polling:

1. Salve o job_id recebido na resposta
2. Faça polling em GET /public/v1/job/{job_id} para verificar o status
3. Quando o status se tornar Succeed, consulte o resultado em image_urls

Fluxo de Status: Pending → Succeed ou Failed

Exemplo de Requisição

cURL (sem imagem):

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/effect/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "description=apply a glowing fantasy aura" \
-F "quality=standard" \
-F "frame=4"

cURL (com imagem):

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/effect/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "description=apply a neon cyberpunk effect" \
-F "quality=pro" \
-F "frame=16" \
-F "image=@/path/to/input.png"