Melhorar Qualidade

Propósito

Este endpoint melhora a qualidade da imagem enviada em alta resolução. Expande a imagem original para resoluções 1K, 2K ou 4K, criando uma imagem mais nítida e de alta qualidade.

Método e Caminho

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

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 upscaling (PNG, JPG, JPEG, etc.)
scale	string	Obrigatório	Resolução de destino. Valores possíveis: "1K", "2K", "4K"

Valores de Scale

• "1K": Upscaling para resolução base de 1024px
• "2K": Upscaling para resolução base de 2048px
• "4K": Upscaling para resolução base de 4096px

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 ou valor de scale inválido

Comportamento do Job Assíncrono

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

Fluxo do Job:

1. Envie o arquivo de imagem e o parâmetro scale para receber imediatamente um job_id
2. O processamento de upscaling ocorre em segundo plano
3. Consulte o status fazendo polling no endpoint GET /job/{job_id}
4. Quando o status mudar para Succeed, verifique a URL da imagem resultante 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/upscale" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "scale=2K"

Exemplo de Resposta

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