Sprite Plus

Propósito

Gera uma animação de sprite a partir de um quadro inicial e de um quadro final opcional. É o mesmo recurso da aba Plus da página "Gerar sprites" do web app (Sprite Lite & Plus). Escolha o número de quadros com frame, exatamente como mostrado no controle deslizante da página web.

Custo em créditos: 9 (49 quadros), 13 (81 quadros)

Método e Caminho

POST /public/v1/sprite/plus

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 Requisição

Envie a requisição como multipart/form-data.

Nome do Campo	Tipo	Obrigatório	Padrão	Descrição
start_image	file	Sim		Quadro inicial (PNG ou JPEG)
end_image	file	Não		Quadro final (opcional) (PNG ou JPEG)
text	string	Sim		Prompt descrevendo o movimento. Espaços em branco são removidos e o texto não pode estar vazio
frame	integer	Sim		Quadros. Valores permitidos: `49`, `81`
is_pixel	boolean	Não	`false`	Pixel art. Ative esta opção se a imagem anexada for baseada em pixel art
is_prompt_enhancement	boolean	Não	`true`	Aprimoramento do prompt. Refina o que você escreveu para ficar mais adequado à geração de sprites

Créditos por frame

frame	Créditos
49	9
81	13

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 os resultados

Regras de Erro / Validação

Situação	Status HTTP	Mensagem de Erro
Uma das imagens não é um arquivo PNG ou JPEG válido	400	"Invalid image file"
O valor de frame não é permitido	400	"frame should be one of 49, 81"
text está vazio	400	"text must not be empty"
Chave de API inválida	401	"Invalid API key"
Campo ausente	422	Erro de validação

Comportamento do 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:

Salve o job_id recebido na resposta
Faça polling em GET /public/v1/job/{job_id} para verificar o status
Quando o status se tornar Succeed, verifique os resultados em image_urls (sprite sheet e GIF)

Fluxo de Status: Pending → Succeed ou Failed

Exemplo de Requisição

cURL (apenas quadro inicial):

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

cURL (quadro inicial + quadro final):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/plus" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "start_image=@/path/to/character_start.png" \
-F "end_image=@/path/to/character_end.png" \
-F "text=running animation cycle" \
-F "frame=81"

Propósito​

Método e Caminho​

Autenticação​

Campos da Requisição​

Resposta​

Regras de Erro / Validação​

Comportamento do Job Assíncrono​

Exemplo de Requisição​