Introdução
O que este endpoint faz
Ele recebe uma foto e devolve uma cópia com até três rostos restaurados e mais nítidos, começando pelo maior. Tudo fora dos rostos fica como estava, e a resolução não muda. Não há prompt.
Entradas que importam
image_url é a foto: um upload em JPEG, PNG ou WebP, ou uma URL pública. `Escolha para o Face Enhancer um rosto real, visível e grande o bastante na imagem; a restauração dos detalhes faciais de uma foto com Face Enhancer aproveita melhor esses detalhes do que um rosto distante ou oculto. Escolha para o Face Enhancer um rosto real, visível e grande o bastante na imagem; a restauração dos detalhes faciais de uma foto com Face Enhancer aproveita melhor esses detalhes do que um rosto distante ou oculto.
O que você recebe
Uma imagem por requisição, na mesma resolução que você enviou, servida pelo armazenamento da plataforma quando a tarefa termina. Para mais pixels, use /models/image-upscaler-v1.
| Campo | Valor |
|---|---|
| Entrada | Imagem |
| Saída | Imagem |
| Endpoint | Edição de imagem |
| Rostos | Até três, começando pelo maior |
| Todo o resto | Fica como estava |
| Controles | Sem prompt, só o formato do arquivo |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | A foto a restaurar: um upload em JPEG, PNG ou WebP, ou um link público para o arquivo. pelo menos 1 caracteres |
output_format | Não | jpeg (padrão), png ou webp. O png evita mais uma rodada de compressão com perda, mas o arquivo fica maior. |
Preços
$0.012 / imagem
Cobrado a um preço fixo por imagem. O formato de saída não muda o preço, e requisições com falha não são cobradas.
Casos de uso
Fotos redimensionadas e recomprimidas
Imagens que passaram por um app de mensagens, uma rede social ou algumas rodadas de salvamento perdem detalhe primeiro no rosto. Passe por aqui uma vez para trazer de volta olhos, sobrancelhas, barba e textura da pele.
Fotos de perfil e de equipe
Limpe um retrato um pouco desfocado antes de ele ir para um perfil, uma página de equipe ou a biografia de um palestrante. O enquadramento, a iluminação e o fundo continuam como foram fotografados.
Antes de um layout maior
Deixe os rostos limpos primeiro e depois use o Image Upscaler em /models/image-upscaler-v1 se a foto também precisar de mais pixels para um banner ou uma impressão.
Guia de prompt e dicas práticas
Confira os rostos
Escolha para o Face Enhancer um rosto real, visível e grande o bastante na imagem; a restauração dos detalhes faciais de uma foto com Face Enhancer aproveita melhor esses detalhes do que um rosto distante ou oculto. Rostos muito cobertos, muito pequenos ou extremamente borrados, e rostos ilustrados ou de anime, melhoram menos.
Envie
image_urlimage_urlé a foto, como upload em JPEG, PNG ou WebP ou como URL pública. Adicioneoutput_formatse quiser png ou webp em vez de jpeg.Consulte e compare
A chamada é assíncrona: crie a tarefa, consulte até terminar e baixe a imagem do armazenamento da plataforma. Compare com a original em tamanho real, em volta dos olhos e da pele.
Introdução
Face Enhancer restaura e deixa mais nítidos os rostos de uma foto. Ele encontra até três rostos, começando pelo maior, e reconstrói o detalhe que a compressão, o redimensionamento ou o desfoque levaram embora: olhos, sobrancelhas, barba e textura da pele. Tudo fora dos rostos fica como estava, e a imagem volta na mesma resolução que você enviou. Não há prompt e não há nada para ajustar além do formato do arquivo.
Requisição
{
"image_url": "https://example.com/portrait.jpg",
"output_format": "jpeg"
}
image_url é o único campo obrigatório. output_format tem jpeg como padrão; defina png ou webp se preferir.
O que muda e o que fica
Os rostos mudam, o resto da foto não. Em nosso teste pegamos um retrato JPEG de 720×404 de um homem em um bar e o degradamos de propósito: reduzimos o tamanho pela metade, ampliamos de volta e comprimimos forte. Ele voltou em 720×404 após cerca de 9 segundos de processamento. Olhos, sobrancelhas, barba e textura da pele ficaram claramente mais nítidos, e ele continuava reconhecível como a mesma pessoa. A pele saiu um pouco mais lisa do que sairia em uma foto real, e a prateleira de garrafas atrás dele manteve os blocos de compressão originais, porque o fundo não é tocado.
O tamanho também não muda. O Face Enhancer restaura os rostos na resolução que você envia; se precisar de mais pixels, use o Image Upscaler (/models/image-upscaler-v1).
Rostos melhoram mais quando são reais, relativamente grandes e bem visíveis. O Face Enhancer tem menos informação facial se a origem é desenho ou anime, ou o rosto é pequeno, coberto ou muito borrado; isso limita a restauração dos detalhes faciais de uma foto com Face Enhancer.
Fluxo da tarefa
A chamada é assíncrona. Escolha para o Face Enhancer um rosto real, visível e grande o bastante na imagem; a restauração dos detalhes faciais de uma foto com Face Enhancer aproveita melhor esses detalhes do que um rosto distante ou oculto. Volta uma imagem por requisição, cobrada por imagem a um preço fixo, e requisições com falha não são cobradas.
Dicas
- Comece com uma foto em que os rostos estejam relativamente grandes e bem visíveis. Um rosto de apenas algumas dezenas de pixels tem pouco o que reconstruir.
- Até três rostos são restaurados, começando pelo maior. Os demais ficam como estavam.
- Use
pngse o resultado for editado ou comprimido de novo: ele evita outra rodada de compressão com perda, mas o arquivo é maior. O formato não muda o preço. - Compare o resultado com a original em tamanho real, em volta dos olhos e da pele. Em nosso teste a imagem saiu um pouco mais lisa do que uma foto real, então guarde o arquivo original.
- Precisa de mais pixels além de rostos mais limpos? Rode o Image Upscaler (
/models/image-upscaler-v1) na foto.
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/face-enhancer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg"
}
}'
# 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.
