Recraft

Recraft Creative Upscale

recraft/creative-upscale

Ampliación de imágenes generativa que, al aumentar la resolución, redibuja y completa texturas, detalles y rasgos faciales, ideal para convertir material de baja calidad en un producto final de alta resolución

recraft/creative-upscale

Precios

recraft/creative-upscale per image

Precio unitario	$0.3575

Descripción general

recraft/creative-upscale es un modelo de ampliación de imágenes generativo de la serie Recraft Creative Upscale. Además de aumentar la resolución de la imagen de entrada, redibuja texturas, detalles finos y rasgos faciales mediante generación, en lugar de limitarse a interpolar. Recibe una URL pública de imagen PNG y admite imágenes de origen de 256–4096 píxeles por lado y hasta 16 MP, lo que lo hace adecuado para desarrolladores que necesitan convertir material de baja resolución o imágenes antiguas en resultados de alta resolución.

Puntos clave

Ampliación con mejora generativa de detalles: a diferencia de la interpolación pura, que solo añade píxeles, complementa texturas y elementos finos durante la ampliación, produciendo resultados aptos para visualización en alta definición.
Mejora y nitidez de rasgos faciales: los rostros borrosos de imágenes generadas por IA o de material antiguo se procesan junto con la ampliación, lo que reduce el trabajo posterior de retoque facial por separado.
Amplio rango de tamaños de entrada: la imagen de origen admite 256–4096 píxeles por lado y hasta 16 MP, desde miniaturas hasta material de mayor tamaño.

Descripción de capacidades

Ampliación de imágenes generativa: basta con pasar una URL de imagen PNG para obtener un resultado ampliado y mejorado, lo que evita el coste de ingeniería de desplegar localmente modelos de superresolución.

Complemento de texturas y detalles: para texturas complejas y elementos finos, se redibujan y completan durante la ampliación, generando recursos de imagen con detalles más completos.

Mejora de rasgos faciales: en entradas de tipo retrato, el proceso de ampliación mejora y afila los rasgos faciales, adecuado para la mejora por lotes de material de retratos.

Entrada directa por URL: solo se necesita un enlace de imagen accesible públicamente, sin subir archivos, lo que facilita la integración con servicios de alojamiento de imágenes y canalizaciones automatizadas existentes.

Casos de uso

Diseñadores que mejoran material de baja resolución: introducen la URL de un borrador de diseño de baja calidad o de una imagen externa y obtienen una imagen final de alta resolución apta para visualización en alta definición o impresión.
Restauración de imágenes generadas por IA y material antiguo: introducen retratos borrosos o imágenes antiguas y obtienen versiones con rostros y detalles más nítidos, para su republicación o reutilización de material.
Canalizaciones automatizadas de procesamiento de imágenes: se invoca por lotes en el servidor con URLs de imágenes, usando la ampliación y mejora como una etapa del flujo de trabajo para producir imágenes estandarizadas en alta definición.

Limitaciones y recomendaciones de selección

El redibujado generativo puede alterar el contenido de la imagen original, por lo que no es adecuado para escenarios que exijan fidelidad a nivel de píxel o una restauración estricta de los detalles originales. Está orientado a la ampliación y mejora, no a la generación de contenido, y tampoco es adecuado como herramienta genérica de edición imagen a imagen. La imagen de origen debe ser un enlace PNG accesible públicamente y está sujeta al límite de 256–4096 píxeles por lado y 16 MP. Si solo se desea aumentar la resolución manteniendo intacto el contenido de la imagen, debe utilizarse un método de ampliación no generativo.

Preguntas frecuentes

Ver todas las preguntas →

¿Qué hace Recraft Creative Upscale?

Amplía una imagen a una resolución mayor y, al mismo tiempo, vuelve a dibujar las texturas y los detalles. No requiere un prompt, solo se pasa una URL de imagen.
¿Cuál es la diferencia con Recraft Crisp Upscale?

Crisp Upscale busca mantenerse fiel a la imagen original, ideal para materiales que no deben modificarse, como textos o productos; Creative Upscale redibuja los detalles y logra una imagen más refinada, pero la estructura local puede diferir de la original.
¿Cambiará el contenido de la imagen?

La composición general, el sujeto y la combinación de colores se conservan básicamente, pero los detalles se vuelven a dibujar. En el ejemplo de esta página, los troncos de la cabaña de madera, el muro de piedra y la barandilla se han redibujado con mayor claridad, el arbolito junto al porche no se ha conservado y la disposición de las piedras también ha cambiado. Para materiales con requisitos estrictos en los detalles, confirme primero en Playground.
¿Qué requisitos deben cumplir las imágenes de entrada?

Envía una URL de imagen http(s) accesible públicamente, de no más de 20 MB, con 256–4096 píxeles por lado y un total de píxeles no superior a 16 MP. Los ejemplos de esta página usan imágenes PNG; por ahora se recomienda usar PNG.

Crear una tarea de generación

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

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: recraft/creative-upscale

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para recraft/creative-upscale y la ruta default; consulta la tabla de parámetros a continuación.

image_urlstringObligatoriominLength 1pattern ^https?://

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

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
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"
}

Obtener el detalle de la tarea

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

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "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
      }
    ]
  }
}

En proceso (no terminal)

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

Fallido

{
  "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"
    }
  }
}