Introdução
O que este endpoint faz
Ele recebe uma imagem e devolve uma cópia maior e mais nítida no nível de tamanho escolhido. Composição, cores e assunto ficam como você enviou, e não há prompt.
Entradas que importam
image_url é a imagem a ampliar. resolution escolhe o nível: 2k (cerca de 4 megapixels), 4k (cerca de 17, o padrão) ou 8k (cerca de 67). A proporção é mantida, e um nível menor que a original reduz a imagem. output_format define o tipo de arquivo: jpeg (padrão), png ou webp.
O que você recebe
Uma imagem por requisição, servida pelo armazenamento da plataforma quando a tarefa termina.
| Campo | Valor |
|---|---|
| Entrada | Imagem |
| Saída | Imagem |
| Endpoint | Upscale |
| Níveis de tamanho | 2K (~4 MP), 4K (~17 MP), 8K (~67 MP) |
| Proporção | A mesma da original |
| Controles | Sem prompt: só nível de tamanho e formato de arquivo |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | Um link direto para o arquivo de imagem (JPEG, PNG ou WebP). Enquadramento e proporção são mantidos sem alteração. pelo menos 1 caracteres |
resolution | Não | 2k (cerca de 4 MP), 4k (cerca de 17 MP, o padrão) ou 8k (cerca de 67 MP), com a proporção mantida. |
output_format | Não | jpeg (padrão) mantém os arquivos administráveis: cerca de 8 MB mesmo no maior nível no nosso teste. png não tem perda, mas é várias vezes maior; webp fica no meio. |
Preços
$0.012 / imagem
Cobrado por imagem gerada. O nível de tamanho e o formato de arquivo não mudam o preço.
Casos de uso
Renders de IA em tamanho de impressão
A maioria dos modelos de imagem entrega um ou dois megapixels. Com 4k ou 8k você leva um render ao tamanho de pôster ou impressão sem gerar de novo e sem perder a versão de que gostou.
Fotos de produto e catálogo
Amplie um packshot para visualizações com zoom e páginas de produto de alta densidade, com a iluminação e o rótulo exatamente como foram fotografados.
Imagens pequenas em layouts novos
Leve uma miniatura, uma foto em tamanho web ou um material antigo ao tamanho que um banner principal ou um slide pede hoje.
Guia de prompt e dicas práticas
Confira o tamanho da original
Escolha um nível acima da quantidade de pixels atual; um nível menor reduz a imagem. Faça o upscale por último, depois de todas as edições, para que as etapas seguintes não precisem processar o arquivo maior.
Envie
image_urle resolutionimage_urlé a imagem e resolution escolhe 2k, 4k (padrão) ou 8k. Adicioneoutput_formatsó se você quiser png ou webp em vez de jpeg.Consulte e baixe
A chamada é assíncrona: crie a tarefa, consulte até terminar e baixe o arquivo do armazenamento da plataforma. Um jpeg em 8k tem cerca de 8 MB, então reserve tempo para o download.
Introdução
Image Upscaler amplia uma imagem finalizada para o nível 2k, 4k ou 8k e a deixa mais nítida no caminho. A imagem em si não muda: composição, cores e assunto ficam exatamente como você enviou. Não há prompt nem nada para ajustar além do tamanho e do formato de arquivo.
Requisição
{
"image_url": "https://example.com/product.png",
"resolution": "4k",
"output_format": "jpeg"
}
Só image_url é obrigatório. resolution é 4k por padrão e output_format é jpeg.
Como os níveis se comportam
O nível é um orçamento de pixels, não uma tela fixa, e a proporção é sempre mantida. Uma foto de 1024×1536 voltou em 1672×2508 com 2k, 3344×5017 com 4k e 6689×10033 com 8k, cada uma em cerca de 45 segundos. Uma original que já é maior que o nível é reduzida: uma imagem de 3344×5017 enviada com 2k voltou em 1672×2509.
Fluxo da tarefa
A chamada é assíncrona. Crie a tarefa, consulte até ela chegar a um estado final e baixe a imagem do armazenamento da plataforma. Volta uma imagem por requisição.
Dicas
- Escolha um nível acima da quantidade de pixels da original.
- Faça o upscale por último, depois de todas as edições, para que as etapas seguintes não processem o arquivo maior.
- Comece pela original mais limpa disponível: artefatos de compressão e desfoque também são ampliados.
- Use
jpega menos que você precise de saída sem perda. Nosso jpeg em 8k ficou com cerca de 8 MB; umpngé várias vezes maior.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/image-upscaler-v1/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "4k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
