Reskin de Sprite V1

Propósito

Altera a aparência de uma imagem de sprite existente para criar um sprite em um novo estilo. Usado para mudar a aparência de um personagem ou converter para um estilo diferente.

Método e Caminho

POST /public/v1/sprite/reskin/v1

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

Nome do Campo	Tipo	Obrigatório	Descrição
image	file	Sim	Arquivo de imagem de sprite original para reskin
description	string	Sim	Descrição das mudanças que serão aplicadas ao sprite
resolution	string	Sim	Resolução de saída. Valores possíveis: 1K, 2K, 4K
style	string	Não	Especificação de estilo. Valores possíveis: pixel, cartoon, sd, quater_view

Resposta

Resposta de Sucesso (200 OK):

{
  "job_id": "uuid-string"
}

Campo	Tipo	Descrição
job_id	string	Identificador único do job criado. Consulte o resultado em Get Job Status

Regras de Erro / Validação

Situação	Status HTTP	Descrição
Invalid image file	400	"Invalid image file"
Valor de resolution inválido	422	Valores diferentes de 1K, 2K, 4K resultam em erro de validação
Valor de style inválido	422	Valores diferentes de pixel, cartoon, sd, quater_view resultam em erro de validação
Falha de autenticação	401	Chave de API inválida

Opções de Estilo:

• pixel: Estilo pixel art
• cartoon: Estilo cartoon
• sd: Estilo SD (Standard Definition)
• quater_view: Estilo quarter view (isométrico)

Comportamento do Job Assíncrono

Este endpoint cria um job assíncrono. Ele retorna imediatamente um job_id, e o trabalho real de reskin 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 for Succeed, verifique o resultado em image_urls

Fluxo de Status: Pending → Succeed ou Failed

Exemplo de Requisição

cURL (estilo básico):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/reskin/v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/sprite.png" \
-F "description=change the warrior character armor to golden" \
-F "resolution=2K"

cURL (com especificação de estilo pixel):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/reskin/v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/sprite.png" \
-F "description=convert the character to pixel art style" \
-F "resolution=1K" \
-F "style=pixel"