Introdução
Ampliação Gigapixel
Gigapixel permite ampliação de precisão ou reconstrução generativa. Sem informar o preset, você usa standard_v2.
Configure a solicitação
Envie image_url e selecione resolution: 2k, 4k ou 8k, com 4k como padrão. O formato inicial é JPEG.
Condições de entrega
Para preservar transparência, combine preset: transparent e output_format: png, depois confira as bordas.
| Campo | Valor |
|---|---|
| Entrada | Imagem |
| Saída | Imagem |
| Preset inicial |
|
| Faixa inicial | 4K |
| Cobrança | Por imagem, conforme preset e faixa |
Recursos e destaques
Mais pixels não deixam os olhos nítidos por si só
Da esquerda para a direita: original, Standard V2 e Wonder 4. Standard também amplia o desfoque; Wonder reconstrói um rosto mais definido, mantendo a semelhança geral neste teste.
Confira se os traços continuam os mesmos
Redefine deixou o homem mais jovem e alterou suas feições. Recover 3 e Standard MAX também reconstruíram detalhes; Detail manteve este rosto muito desfocado mais suave. São observações de uma única imagem.
A rosa aumenta e o fundo continua transparente
A rosa recortada em tons de amarelo e laranja passou de 400×301 para 2360×1776 com o canal alfa preservado. As pontas rosadas das pétalas têm gotas de água, e também aparecem um pequeno trecho de caule verde e folhas. O fundo escuro serve apenas para visualizar a comparação; o arquivo do exemplo mantém a transparência.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | A foto ou arte JPEG, PNG ou WebP que você vai ampliar com Gigapixel. pelo menos 1 caracteres |
preset | Não | Doze opções: cinco de precisão, seis generativas e |
resolution | Não |
|
output_format | Não | Gigapixel entrega |
Preços
Gigapixel cobra por imagem processada conforme preset e resolution. Alterar output_format não muda o valor cobrado.
| Resolução | Predefinição de estilo: cgi | Predefinição de estilo: detail | Predefinição de estilo: high_fidelity_v3 | Predefinição de estilo: low_resolution_v2 | Predefinição de estilo: standard_v2 | Predefinição de estilo: text_refine | Predefinição de estilo: transparent | Predefinição de estilo: wonder_3_5 | Predefinição de estilo: wonder_4 | Predefinição de estilo: recover_3 | Predefinição de estilo: redefine | Predefinição de estilo: standard_max |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.24 / imagem | $0.24 / imagem | $0.24 / imagem |
| $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.12 / imagem | $0.36 / imagem | $0.36 / imagem | $0.60 / imagem | $0.60 / imagem | $0.60 / imagem |
| $0.36 / imagem | $0.36 / imagem | $0.36 / imagem | $0.36 / imagem | $0.36 / imagem | $0.36 / imagem | $0.36 / imagem | $1.08 / imagem | $1.08 / imagem | $2.04 / imagem | $2.04 / imagem | $2.04 / imagem |
Casos de uso
Preparar uma impressão
Escolha a faixa de saída e confira rostos e padrões finos antes de imprimir.
Ampliar um logo recortado
Você pode usar text_refine para texto e gráficos ou transparent para manter o fundo transparente do PNG.
Guia de prompt e dicas práticas
Informe a imagem
Envie a foto ou arte JPEG, PNG ou WebP em
image_url.Escolha a reconstrução
Comece com
standard_v2para preservar o conteúdo ou selecionewonder_4para reconstruir detalhes.Defina a entrega
Ajuste
resolutione o formato; combinetransparentcomoutput_format: png.
Ampliação Gigapixel
Aplique um preset Gigapixel à sua foto ou arte e receba uma ampliação na faixa escolhida; o modo transparente entrega sempre PNG.
Configure a solicitação
{
"image_url": "https://example.com/blurred-portrait.jpg",
"preset": "standard_v2",
"resolution": "2k",
"output_format": "jpeg"
}
Guia de presets
preset | Melhor ponto de partida |
|---|---|
standard_v2 | Fotos em geral; precisão padrão |
high_fidelity_v3 | Material já nítido em alta resolução |
low_resolution_v2 | Imagens muito pequenas ou comprimidas |
cgi | Ilustrações e renderizações |
text_refine | Texto, logos e gráficos |
wonder_4 | Modelo generativo versátil mais recente |
wonder_3_5 | Reconstrução generativa Wonder 3.5 |
recover_3 | Fotografias muito degradadas |
standard_max | Reconstrução generativa de detalhes |
redefine | Adiciona detalhes e pode alterar a semelhança |
detail | Pele mais realista em rostos de IA |
transparent | Ampliação PNG com alfa |
Resultados observados
Da esquerda para a direita: original, Standard V2 e Wonder 4. Standard também amplia o desfoque; Wonder reconstrói um rosto mais definido, mantendo a semelhança geral neste teste.
Redefine deixou o homem mais jovem e alterou suas feições. Recover 3 e Standard MAX também reconstruíram detalhes; Detail manteve este rosto muito desfocado mais suave. São observações de uma única imagem.
A rosa recortada em tons de amarelo e laranja passou de 400×301 para 2360×1776 com o canal alfa preservado. As pontas rosadas das pétalas têm gotas de água, e também aparecem um pequeno trecho de caule verde e folhas. O fundo escuro serve apenas para visualizar a comparação; o arquivo do exemplo mantém a transparência.
Condições de entrega
Cada solicitação processa uma imagem com um preset. Modelos generativos podem alterar rostos e pequenos detalhes e não são adequados para documentos de identidade ou restauração com valor de prova. Arquivos 8K podem ser grandes. transparent rejeita a saída JPEG.
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": "topaz/gigapixel/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "standard_v2",
"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.
