Aprimorador de Qualidade (Upscale)

O endpoint Aprimorador de Qualidade permite que você aumente e aprimore inteligentemente a resolução e os detalhes mais finos das imagens, suportando até a resolução 4K.

Nome do Modelo: upscale

Ciclo de Vida: stable

Tempo de Processamento: ~8s–20s

Formato de Saída: Auto (JPEG ou PNG)

Métodos de Entrega: URL

Créditos: 3 a 4 por imagem (2k: 3, 4k: 4)

Requisição

Envie sua imagem e resolução alvo para o endpoint universal /v1/run:

POSThttps://fititon.app/api/v1/run

Exemplos de Requisição

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "upscale",
           "inputs": {
             "imageUrl": "https://example.com/1k-image.jpg",
             "targetQuality": "2k"
           }
         }'

Resposta

Como o upscale pode levar até 20 segundos, o endpoint /v1/run retorna um status 201 Created imediatamente com um id de job assíncrono. Você deve consultar a API de Status usando este id para recuperar a imagem final. Alternativamente, você pode configurar webhooks para receber notificações automaticamente. Observe que nosso despachante de webhook impõe um tempo limite estrito de 15 segundos. Seu servidor deve reconhecer o webhook com um código de status 2xx dentro de 15 segundos, ou o consideraremos falho e o tentaremos novamente mais tarde.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "upscale"
}

Quando o job for concluído (status: "success"), o campo output conterá o array de URLs resultantes:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/upscale-123.jpg"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

Parâmetros da Requisição

Parâmetros Obrigatórios

imageUrlRequiredstring

A imagem de origem que você deseja aprimorar. Pode ser uma URL publicamente acessível ou uma string de imagem codificada em Base64.

Requisito de Formatação e Payload Ao enviar uma string Base64, ela deve incluir o prefixo URI de dados padrão (por exemplo, data:image/jpeg;base64,...). Além disso, recomendamos fortemente o uso de URLs HTTP padrão para imagens maiores que 3MB para evitar atingir os limites globais de tamanho de payload JSON (HTTP 413).

targetQualityRequired'2k' | '4k'

O nível de resolução de saída desejado. Nota: Imagens maiores que 4.25 megapixels não podem usar targetQuality="2k" e devem ter como alvo 4k.

Erros de Tempo de Execução

Os erros de tempo de execução para este recurso usam o conjunto compartilhado documentado em Tratamento de Erros. Se ocorrer um erro durante o processamento, o status será atualizado para "error" e o campo error conterá o motivo específico da falha.

Custo de Crédito

Para requisições da API de Desenvolvedor, o custo varia dependendo do targetQuality.

Fórmula: Custo = CréditosDeQualidade

Parâmetro	Créditos por Imagem
`targetQuality="2k"`	3
`targetQuality="4k"`	4