Escalar una imagen
Este endpoint toma una imagen y la remuestrea a unas dimensiones en píxeles mayores, para cuando un archivo pequeño tiene que encajar en una maqueta pensada para uno más grande.
Esta tarea no está disponible ahora mismo, así que no se puede contratar. No se cobra nada por ella.
Cómo funciona y APIEs un agrandado normal de buena calidad, no un escalador que reconstruye detalle: no añade información que no estuviera en el original, así que una foto agrandada se ve más blanda que una tomada a ese tamaño. Por ahora no está disponible y no acepta trabajos; la nota de abajo explica por qué, y el endpoint y el precio que ve aquí son los que usaría si vuelve.
Qué puede y qué no puede hacer un agrandado normal
Agrandar una imagen es remuestrearla: los píxeles existentes se reparten sobre un lienzo mayor y los huecos se rellenan por interpolación. Eso basta para que una imagen pequeña alcance un tamaño exigido, pero la interpolación no puede añadir información que la fuente nunca registró. Los bordes finos se suavizan, el texto pequeño se emborrona y la textura se aplana cuanto mayor es el factor: un agrandado 4x lo muestra más que uno 2x. Cualquier herramienta que afirme 'restaurar' detalle perdido está describiendo un modelo más pesado, basado en GPU, que este endpoint no ejecuta.
Por qué esta herramienta no está disponible ahora
Un agrandador que de verdad reconstruya detalle necesita un modelo neuronal de superresolución, y esos necesitan una GPU para funcionar a un coste razonable. La plataforma que hay detrás de este endpoint solo ofrece CPU, así que la versión honesta de esta herramienta —una que no prometa más de lo que un remuestreo por CPU puede dar— sigue en revisión. Hasta entonces el endpoint no acepta trabajos, y no se cobra nada por una tarea que no puede ejecutarse.
Cuándo sigue siendo útil un agrandado normal
Remuestrear a un tamaño mayor tiene usos reales aun sin añadir detalle: cumplir las dimensiones mínimas en píxeles de una plantilla, imprimir un gráfico pequeño a un tamaño físico fijo o normalizar un conjunto mixto de imágenes a una sola resolución. En cada caso el valor está en el cambio de tamaño, no en una nitidez nueva: el resultado se verá como el original a mayor escala, que para muchas tareas de maqueta e impresión es justo lo que hace falta.
Formatos y cómo funcionaría
Se aceptarían los formatos rasterizados comunes como entrada, y usted elegiría el formato de salida. Cuando la herramienta vuelva, funcionaría de forma asíncrona: envíe la imagen y un factor objetivo, reciba un task_id y obtenga el archivo agrandado por enlace firmado en cuanto esté listo, útil cuando el agrandado es una etapa de un trabajo mayor, como preparar un catálogo mixto a un tamaño mínimo común.
Qué puede hacer con ella
Cumplir el tamaño mínimo de una plantilla
Una plantilla de listado exige un tamaño mínimo en píxeles y una imagen de origen más pequeña se agranda para encajar, asumiendo que el resultado queda más blando, no más nítido.
Impresión a tamaño fijo
Un logotipo o gráfico pequeño se agranda a las dimensiones en píxeles que una maqueta de impresión espera para un tamaño físico dado.
Normalizar un conjunto mixto
Un lote de imágenes de distintos tamaños se remuestrea a una sola resolución común antes de maquetar, sin pretender añadir detalle.
Llenar un marco más grande
Un avatar pequeño se agranda para reutilizarlo en un marco mayor en los casos en que un resultado más blando es aceptable.
Preguntas frecuentes
¿Cómo agrandaría una imagen con la api?
Esta herramienta todavía no está disponible. Cuando vuelva, haría un POST a /image/upscale con la imagen de origen y un factor objetivo, 2x o 4x, y recibiría un task_id junto con la imagen agrandada por webhook o enlace firmado.
¿Cuál es la diferencia entre 2x y 4x?
2x duplica ancho y alto, 4x los cuadruplica. Como un agrandado normal no puede añadir detalle, cuanto mayor es el factor más blando se ve el resultado.
¿Esto vuelve nítida una foto borrosa?
No. Un agrandado normal remuestrea la imagen a un tamaño mayor; no puede recuperar detalle que nunca se captó, así que una fuente borrosa o muy comprimida sigue blanda: más grande, no más nítida.
¿Hay un plan gratuito para la api de agrandar imagen?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cuánto cuesta agrandar una imagen?
$0.061 por solicitud más $0.0041 por imagen, y solo se cobran las tareas completadas.
¿Ya está disponible la api de agrandar imagen?
No. Está retirada temporalmente mientras se rehace para que no prometa un detalle que un remuestreo por CPU no puede dar. El endpoint y el precio que ve aquí son los que usaría si vuelve.
¿Qué formatos de imagen podría agrandar?
Se aceptarían los formatos rasterizados comunes como entrada, y usted elegiría el formato de salida para el resultado agrandado.
¿Podría agrandar un lote grande de imágenes de una vez?
Sí, combinaría este endpoint con la API de Procesamiento en Lote para agrandar muchas imágenes en una sola llamada, cada una cotizada por separado.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. Esta capacidad está disponible actualmente mediante la API, no como herramienta interactiva en la Web.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/image/upscale \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"image":"https://example.com/photo.jpg"}'const res = await fetch("https://api.kit.forhosting.com/image/upscale", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"image": "https://example.com/photo.jpg"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/upscale",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"image": "https://example.com/photo.jpg"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/upscale", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"image":"https://example.com/photo.jpg"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"image":"https://example.com/photo.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/upscale", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"image": "https://example.com/photo.jpg"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.upscale",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 15 |
max_megapixels | 12 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
501 | coming_soon | Capacidad en despliegue (Fase 1b). Su landing existe; aún no acepta ejecuciones. |