Poner texto en una imagen
Ponga el precio sobre la foto de un producto, un titular sobre un banner o la etiqueta Vendido sobre un anuncio, con el texto integrado en los píxeles. Usted elige la posición, el tamaño, el color y un recuadro de fondo opcional. Paga por uso, sin suscripción.
Esta tarea no está disponible ahora mismo, así que no se puede contratar. No se cobra nada por ella.
Cómo funciona y APIUna foto de producto sin etiqueta de precio, un banner sin titular, una miniatura sin rótulo: todas quedan a medio terminar hasta que el texto se posa sobre los píxeles.
Por qué una imagen no está terminada hasta que lleva su texto
Una foto de producto sin su precio, un banner sin titular o una miniatura sin rótulo están a medio hacer. Lo que separa una foto en bruto de una imagen lista son unas pocas decisiones pequeñas: dónde va el precio, de qué tamaño es el titular y si el texto necesita un recuadro de fondo para leerse sobre una foto recargada. Para una persona son fáciles una vez, pero se vuelven pesadas cuando se repiten todo el día. Aquí usted las indica una sola vez, el texto, su posición, su tamaño, su color y el recuadro opcional, y se aplican igual en cada imagen.
Dónde se usa y qué conviene tener en cuenta
Los mercados en línea estampan el precio vigente en cada foto en cuanto el vendedor lo cambia. Los equipos de marketing preparan una semana de banners para redes a partir de un fondo y una hoja de cálculo con titulares y fechas. Los portales inmobiliarios marcan las fotos como Disponible, Vendido o Reservado según cambia el estado, y los programadores de contenido colocan una cita diaria sobre un fondo antes de publicarla. Guarde su original limpio: el texto queda dibujado en los píxeles y no en una capa aparte, así que para cambiar una palabra se crea una versión nueva desde el original.
Qué puede hacer con ella
Estampado de precios en marketplaces
Una plataforma de anuncios superpone el precio vigente en cada foto de producto en el momento en que el vendedor lo actualiza, manteniendo las imágenes sincronizadas con el inventario.
Banners promocionales por lotes
Un equipo de marketing genera los banners de redes sociales de toda la semana a partir de una plantilla de fondo y una hoja de cálculo con titulares y fechas.
Etiquetas de estado inmobiliario
Un portal inmobiliario estampa 'Disponible', 'Vendido' o 'Reservado' sobre las fotos de las propiedades de forma automática según cambia el estado.
Piezas de citas y rótulos
Un programador de contenido graba una cita diaria sobre una imagen de fondo antes de dejarla lista para publicar, sin ningún paso manual de diseño.
Preguntas frecuentes
¿Tiene prueba gratuita?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Puedo añadir más de una línea de texto?
Sí, se pueden colocar varios elementos de texto sobre la misma imagen en una sola llamada, cada uno con su propia posición y estilo.
¿Qué formatos de imagen admite?
Se aceptan formatos rasterizados comunes como JPEG y PNG, y el resultado conserva el formato y las dimensiones de la imagen de origen.
¿Puedo controlar la fuente, el tamaño y el color?
Sí, el tamaño de fuente, el color y un fondo opcional son parámetros que define por cada elemento de texto para tener control total sobre el resultado.
¿Se cobra si el proceso falla?
No. Una tarea fallida se reintenta automáticamente hasta tres veces y nunca se cobra; en su lugar recibe un error claro.
Herramientas relacionadas
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/text-overlay \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"image":"https://ejemplo.com/imagen.jpg","text":"OFERTA"}'const res = await fetch("https://api.kit.forhosting.com/image/text-overlay", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"image": "https://ejemplo.com/imagen.jpg",
"text": "OFERTA"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/text-overlay",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"image": "https://ejemplo.com/imagen.jpg",
"text": "OFERTA"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/text-overlay", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"image":"https://ejemplo.com/imagen.jpg","text":"OFERTA"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg","text":"OFERTA"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/text-overlay", 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://ejemplo.com/imagen.jpg",
"text": "OFERTA"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.text_overlay",
"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. |
Notas técnicas
Este endpoint coloca uno o varios textos sobre una imagen en la posición, tamaño y color que defina, y devuelve un archivo terminado en lugar de uno a medio construir.
La distancia entre una foto y una pieza terminada
Entre una foto sin procesar y una imagen lista para publicar hay un puñado de decisiones de diseño que son triviales para una persona y tediosas de automatizar: dónde va el precio, qué tamaño lleva el titular, si el texto necesita un fondo para seguir siendo legible sobre una foto cargada de detalles. Este endpoint recibe esas decisiones como parámetros —texto, posición, tamaño de fuente, color, fondo opcional— y las aplica igual cada vez, algo que importa mucho más de lo que suena cuando lo hace mil veces al día.
Quién coloca texto sobre imágenes a gran escala
Marketplaces que estampan el precio o una insignia de 'vendido' en cada foto de anuncio, equipos de comercio electrónico que generan un lote de banners promocionales a partir de una plantilla y una hoja de cálculo de titulares, herramientas de programación de redes sociales que graban una cita o un rótulo sobre una imagen de fondo antes de publicarla, plataformas inmobiliarias que añaden una etiqueta de estado como 'disponible' o 'reservado' a cada foto de propiedad.
Qué ocurre realmente con el archivo
Envía la imagen de origen junto con el texto y su ubicación, recibe de inmediato un task_id, y la tarea graba el texto directamente en la imagen —no como una capa aparte, sino integrado en los píxeles— de modo que el archivo que regresa está listo para publicarse tal cual, sin abrir ningún programa de diseño.
Dónde encaja en un flujo más amplio
Como cada llamada se cobra por imagen y responde de forma asíncrona, encaja de forma natural después de que una imagen se sube o se genera y antes de que se publica: se fotografía un anuncio, el precio se superpone automáticamente, y la imagen terminada pasa directo al escaparate sin que nadie abra un editor en el medio.
Una operación pequeña con impacto grande
Superponer texto es uno de los trucos más antiguos de la edición de imágenes —anterior incluso a las herramientas digitales, con raíces en la rotulación a mano y el revelado analógico— pero hacerlo de forma correcta y uniforme en miles de imágenes al día es un problema muy distinto a hacerlo bien una sola vez en un editor, y ese es el vacío que cierra este endpoint.
Preguntas técnicas
¿Cómo pongo texto en una imagen con esta API?
Envíe un POST a /image/text-overlay con la imagen de origen y el texto junto con su posición, tamaño y color; recibe un task_id y la imagen terminada llega por webhook o enlace firmado.
¿Cómo se cobra?
$0.002 por solicitud más $0.005 por imagen, un precio publicado y plano sin importar cuánto texto se coloque.
¿Puedo procesar un lote de fotos de producto a la vez?
Cada llamada procesa una imagen y devuelve su propio task_id, así que procesar mil fotos de producto es simplemente mil solicitudes en paralelo recogidas por webhook.