Criar Sprite V2

Propósito

Gera animações de sprite com base na imagem enviada. Você pode criar folhas de sprite em estilo pixel art ou estilo regular.

Método e Caminho

POST /public/v1/sprite/make-sprite/v2

Autenticação

Consulte a página de autenticação. É necessário um token Bearer.

Cabeçalhos Obrigatórios:

Authorization: Bearer {your_api_key}

Campos da Solicitação

Nome do Campo	Tipo	Obrigatório	Descrição
start_frame_image	file	Sim	Arquivo de imagem base para o frame inicial
end_frame_image	file	Não	Arquivo de imagem opcional base para o frame final
text	string	Sim	Prompt de texto para a geração do sprite
frame	integer	Sim	Número de frames a gerar. Deve ser um de: 49, 81, 121
is_pixel	boolean	Sim	Se a imagem é em estilo pixel art. true ou false

Resposta

Resposta de Sucesso (200 OK):

{
  "job_id": "uuid-string"
}

Campo	Tipo	Descrição
job_id	string	Identificador único do trabalho criado. Use Get Job Status para consultar os resultados

Regras de Erro / Validação

Situação	Status HTTP	Mensagem de Erro
Invalid image file	400	"Invalid image file"
Valor de frame não permitido	400	"frame should be one of 49, 81, 121"
Falha na autenticação	401	Chave de API inválida

Valores de Frame Permitidos:

• 49, 81, 121

Comportamento de Job Assíncrono

Este endpoint cria um job assíncrono. Ele retorna imediatamente um job_id, e a geração real do sprite ocorre 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, verifique os resultados em image_urls (GIF e imagens de frames individuais)

Fluxo de Status: Pending → Succeed ou Failed

Exemplo de Solicitação

cURL (estilo pixel art):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/make-sprite/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "start_frame_image=@/path/to/character.png" \
-F "text=walking animation" \
-F "frame=49" \
-F "is_pixel=true"

cURL (estilo regular):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/make-sprite/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "start_frame_image=@/path/to/character.png" \
-F "text=running animation cycle" \
-F "frame=81" \
-F "is_pixel=false"

cURL (estilo regular + frame final):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/make-sprite/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "start_frame_image=@/path/to/character_start.png" \
-F "end_frame_image=@/path/to/character_end.png" \
-F "text=running animation cycle" \
-F "frame=81" \
-F "is_pixel=false"