Recraft

Recraft Creative Upscale

recraft/creative-upscale

Ampliação generativa de imagens que, ao elevar a resolução, redesenha e complementa texturas, detalhes e traços faciais, ideal para transformar materiais de baixa definição em produtos de alta resolução

recraft/creative-upscale

Preços

recraft/creative-upscale per image

Preço unitário	$0.3575

Visão geral

recraft/creative-upscale é um modelo de ampliação de imagem generativa da série Recraft Creative Upscale. Além de aumentar a resolução da imagem de entrada, ele redesenha texturas, detalhes finos e traços faciais com base em geração, em vez de apenas fazer interpolação. Ele aceita URLs públicas de imagens PNG e suporta imagens de origem com 256–4096 pixels por lado e até 16 MP, sendo adequado para desenvolvedores que precisam elevar materiais de baixa resolução ou imagens antigas a resultados de alta resolução.

Destaques principais

Ampliação com aprimoramento generativo de detalhes — em comparação com a interpolação pura, que apenas adiciona pixels, ele complementa texturas e elementos minúsculos durante a ampliação, gerando saídas prontas para exibição em alta definição.
Melhoria e nitidez de traços faciais — rostos desfocados em imagens geradas por IA ou materiais antigos são tratados junto com a ampliação, reduzindo a etapa de retoque facial separado na pós-produção.
Ampla faixa de tamanho de entrada — a imagem de origem suporta 256–4096 pixels por lado e até 16 MP, de miniaturas a materiais maiores.

Descrição das capacidades

Ampliação generativa de imagem: basta enviar uma URL de imagem PNG para obter um resultado ampliado e aprimorado, eliminando o custo de engenharia de implantar modelos de super-resolução localmente.

Complemento de texturas e detalhes: para texturas complexas e elementos minúsculos, o redesenho e complemento ocorrem durante a ampliação, produzindo ativos de imagem com detalhes mais completos.

Aprimoramento de traços faciais: para entradas do tipo retrato, o processo de ampliação melhora e torna mais nítidos os traços faciais, sendo adequado para aprimoramento em lote de materiais de retrato.

Entrada direta por URL: requer apenas um link de imagem acessível publicamente, sem necessidade de upload de arquivos, facilitando a integração com serviços de hospedagem de imagens existentes e pipelines automatizados.

Cenários de aplicação

Designers aprimorando materiais de baixa resolução — insira a URL de um rascunho de design de baixa qualidade ou de uma imagem externa e obtenha uma imagem final de alta resolução para exibição em alta definição ou impressão.
Restauração de imagens geradas por IA e materiais antigos — insira retratos desfocados ou imagens antigas e receba uma versão com rosto e detalhes mais nítidos, para republicação ou reutilização de materiais.
Pipeline automatizado de processamento de imagens — chame em lote no servidor com URLs de imagens, usando a ampliação e o aprimoramento como uma etapa do fluxo de trabalho para produzir imagens padronizadas em alta definição.

Limitações e recomendações de seleção

O redesenho generativo pode alterar o conteúdo da imagem original, não sendo adequado para cenários que exigem fidelidade em nível de pixel ou restauração estrita dos detalhes originais. Ele é voltado para ampliação e aprimoramento, não para geração de conteúdo, e também não é adequado como ferramenta genérica de edição imagem-para-imagem. A imagem de origem deve ser um link PNG acessível publicamente e está sujeita aos limites de 256–4096 pixels por lado e 16 MP. Se for necessário apenas aumentar a resolução mantendo o conteúdo da imagem inalterado, deve-se usar um método de ampliação não generativo.

Perguntas frequentes

Ver todas as perguntas →

O que o Recraft Creative Upscale faz?

Amplia uma imagem para uma resolução mais alta, redesenhando texturas e detalhes ao mesmo tempo. Não precisa de prompt, basta enviar uma URL de imagem.
Qual é a diferença em relação ao Recraft Crisp Upscale?

O Crisp Upscale busca manter a fidelidade à imagem original, sendo adequado para materiais que não podem ser alterados, como textos e produtos; o Creative Upscale redesenha os detalhes, deixando a imagem mais refinada, mas a estrutura local pode diferir da imagem original.
Isso altera o conteúdo da imagem?

A composição geral, o tema principal e a paleta de cores são basicamente preservados, mas os detalhes são redesenhados. No exemplo desta página, as toras da cabana de madeira, a parede de pedra e o corrimão foram redesenhados com mais clareza, a pequena árvore ao lado da varanda não foi preservada e o arranjo das pedras também mudou. Para materiais com requisitos rigorosos de detalhes, confirme primeiro no Playground.
Quais são os requisitos para a imagem de entrada?

Envie uma URL de imagem http(s) acessível publicamente, com no máximo 20 MB, de 256 a 4096 pixels por lado e total de pixels não superior a 16 MP. O exemplo desta página usa uma imagem PNG, e atualmente recomenda-se usar PNG.

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: recraft/creative-upscale

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para recraft/creative-upscale e a rota default — veja a tabela de parâmetros abaixo.

image_urlstringObrigatóriominLength 1pattern ^https?://

Public URL of the PNG image to upscale. Up to 20 MB, each side 256–4096 px, at most 16 MP.

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "recraft/creative-upscale",
  "input": {
    "image_url": "…"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "recraft/creative-upscale",
    input: {
      "image_url": "…"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "recraft/creative-upscale",
        "input": {
          "image_url": "…"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}