Melhorar qualidade

Propósito

Este endpoint melhora a qualidade das imagens enviadas em resoluções mais altas. Ele amplia a imagem original para a resolução 1K, 2K ou 4K, produzindo imagens mais nítidas e de maior qualidade. É o mesmo recurso da página "Melhorar qualidade" do web app, onde 2K vem selecionado por padrão.

Custo em créditos: 5 (1K), 7 (2K), 10 (4K)

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

Valores de Scale

• "1K": Amplia para a resolução de 1024px
• "2K": Amplia para a resolução de 2048px
• "4K": Amplia para a resolução 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 melhoria de qualidade 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 melhoria de qualidade 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"
}