Separar Camadas

Propósito

Este endpoint separa uma imagem enviada em camadas. Com base em palavras-chave, ele extrai elementos específicos da imagem como camadas individuais.

Método e Caminho

• HTTP Method: POST
• Path: /public/v1/image-tune/split-layer

Autenticação

Este endpoint requer autenticação Bearer Token. Consulte o Guia de Autenticação para mais detalhes.

Cabeçalhos Obrigatórios:

Authorization: Bearer {your_api_key}

Campos da Requisição

Form Data (multipart/form-data)

Nome do Campo	Tipo	Obrigatório	Descrição
image	file	Obrigatório	Arquivo de imagem original para separar em camadas (PNG, JPG, JPEG, etc.)
keyword	string	Obrigatório	Palavra-chave especificando o elemento a ser separado

Diretrizes de Keyword

• Insira uma palavra-chave que descreva o elemento da imagem que deseja separar
• Ex: "arm", "body", "leg"

Resposta

JobIdResponse

Nome do Campo	Tipo	Descrição
job_id	UUID	Identificador único do job criado. Use este ID para consultar o status do job

Regras de Erro / Validação

Código HTTP	Situação de Erro	Descrição
400 Bad Request	Invalid image file	Invalid image file
401 Unauthorized	Falha de autenticação	Chave de API inválida ou cabeçalho de autenticação ausente
404 Not Found	Usuário não encontrado	Usuário vinculado à chave de API não encontrado
422 Unprocessable Entity	Falha de validação	Campo obrigatório ausente

Comportamento do Job Assíncrono

Este endpoint é processado de forma assíncrona. Ele retorna imediatamente um job_id, e o processamento real de separação de camadas ocorre em segundo plano.

Fluxo do Job:

1. Envie o arquivo de imagem e a palavra-chave para receber imediatamente um job_id
2. O processamento de separação de camadas ocorre em segundo plano
3. Consulte o status fazendo polling no endpoint GET /job/{job_id}
4. Quando o status mudar para Succeed, verifique as URLs das camadas separadas em image_urls

Intervalo de Polling: Recomendado 1-2 segundos

Exemplo de Requisição

cURL

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/split-layer" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "keyword=character"

Exemplo de Resposta

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}