2 créditos por llamada
API de eliminación de texto
Borra rótulos, superposiciones, marcas de tiempo y etiquetas incrustadas en tus imágenes por código. La detección es automática, y si la imagen no tiene texto, no se te cobra.
- REST · JSON
- Sin marca de agua
- No se almacena nada
POST /v1/remove-text
¿Qué es la API de eliminación de texto?
La API de eliminación de texto de ImgGen AI es un endpoint REST que localiza el texto de una imagen y lo elimina, reconstruyendo el fondo que había donde estaban los caracteres. Gestiona rótulos, superposiciones, marcas de tiempo y etiquetas incrustadas sin necesidad de máscara. Si el modelo no encuentra texto, la solicitud devuelve un 422 y no se descuenta ningún crédito.
Es uno de los siete endpoints de la API de edición de imágenes de ImgGen AI, que comparten una única clave de API, una única URL base y la misma forma de solicitud y respuesta. Si además necesitas esta función en el navegador y no desde código, el mismo modelo de IA impulsa la herramienta Image Text Remover.
Parámetros de la solicitud
Envía una solicitud POST a https://app.imggen.ai/v1/remove-text, autenticada con una clave de API en la cabecera Authorization.
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| image | file | OBLIGATORIO | — | The image to clean. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
¿Cómo integro la API para eliminar texto de imágenes?
Crea una clave de API en tu cuenta de ImgGen, guárdala como variable de entorno y llama al endpoint. Esta es la misma solicitud en cURL, Node.js y Python.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-text' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-text', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-text",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))Respuesta
Una llamada correcta devuelve JSON. El resultado viene codificado en base64: decodifícalo antes de escribirlo en disco o en tu almacenamiento de objetos. Cada respuesta correcta incluye además una cabecera X-Credit-Remaining con tu saldo tras la llamada.
{
"success": true,
"message": "Text removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}Límites y comportamientos que conviene conocer
El endpoint acepta JPEG (JPG), PNG y WebP con un tamaño máximo de archivo de 25 MB, y responde de forma síncrona en menos de 60 segundos: no hay ningún trabajo que consultar ni ningún webhook que configurar.
Sin texto, sin cargo
Si el modelo no detecta texto en la imagen, el endpoint devuelve 422 VALIDATION_ERROR y no descuenta nada. Puedes lanzarlo sobre un conjunto mixto de imágenes sin pagar por las que ya están limpias.
Relleno generativo, no desenfoque
La zona que había detrás de los caracteres se reconstruye para encajar con su entorno en lugar de emborronarse, así que el resultado aguanta bien sobre fondos con mucho detalle.
Detección automática
No hay ningún parámetro de región ni de recuadro: el modelo encuentra el texto por sí solo, y eso es lo que hace que el endpoint sea seguro de ejecutar sin supervisión.
¿Para qué se usa la API para eliminar texto de imágenes?
Dónde ponen los equipos este endpoint en producción para procesar imágenes de forma programática y a escala.
Flujos de localización
Elimina el texto incrustado en el idioma original de tus imágenes de marketing para poder componer una versión localizada para cada mercado.
Higiene de anuncios en marketplaces
Quita las superposiciones promocionales y las marcas de la competencia que los vendedores añaden a las fotos de producto, aplicando las reglas del catálogo automáticamente.
Limpieza de archivos
Borra las marcas de tiempo y las etiquetas de cámara incrustadas en fotografías escaneadas o antiguas antes de que entren en una fototeca.
Reutilización de plantillas
Recupera una imagen base limpia a partir de una creatividad terminada para que ese mismo diseño pueda llevar un texto nuevo.
¿Cuánto cuesta la API para eliminar texto de imágenes?
Cada llamada correcta cuesta 2 créditos, así que tu coste real por imagen depende del plan que tengas. Los créditos salen de tu plan y se comparten entre todos los endpoints y el editor web, de modo que no compras una cuota separada por herramienta. Una llamada fallida se reembolsa automáticamente. Consulta todos los detalles en la página de precios.
| Plan | Precio | Créditos | API |
|---|---|---|---|
| Free | $0 | 50 créditos gratuitos de una sola vez | Sin acceso a la API |
| Starter | $9.99 / month | 400 créditos / mes | Acceso a la API incluido |
| Pro | $29.99 / month | 1.400 créditos / mes | Acceso a la API + soporte prioritario |
| Enterprise | Custom | Volumen personalizado | Infraestructura dedicada |
Costes en créditos y límites verificados por última vez el 2026-08-27.
Endpoints y herramientas relacionados
Los equipos que usan la API para eliminar texto de imágenes suelen recurrir después a estos.
También disponibles: Escalado de imágenes, Restauración de fotos, Coloreado de fotos, Generación de imágenes.
Preguntas frecuentes sobre la API de eliminación de texto
- Es un endpoint HTTP que detecta los caracteres escritos en una foto y los borra, rellenando el fondo que quedaba oculto detrás. Es el equivalente programático a clonar el texto a mano en un editor, salvo que se ejecuta en un segundo y no necesita que nadie marque la zona.
- La solicitud devuelve un HTTP 422 con el código VALIDATION_ERROR y no se cobra ningún crédito. Eso hace que sea seguro lanzar el endpoint de forma preventiva sobre un lote mixto: solo pagas por las imágenes que realmente tenían texto que eliminar.
- Eso es exactamente lo que hace este endpoint. En lugar de pintar por encima de los caracteres, detecta la región de texto, la elimina y reconstruye el fondo que quedaba oculto usando los píxeles de alrededor como referencia. Todo lo que queda fuera de la región de texto permanece intacto, así que el resto de la foto es idéntico al que enviaste.
- Sí. La detección abarca toda la imagen, así que cada región de texto que encuentre —un rótulo, una marca de tiempo en una esquina y una etiqueta en el centro— se elimina en esa misma llamada. Ten en cuenta que aquí no se admite agrupar varias *imágenes* en una sola solicitud: envía una imagen por solicitud, o usa el endpoint de marcas de agua si necesitas subidas por lotes.
- Fuera de la región de texto no: esos píxeles pasan sin ninguna modificación. Dentro de ella el contenido se genera en lugar de recuperarse, así que un fondo recargado o con mucho detalle es una reconstrucción más difícil que uno plano. La resolución de salida coincide con la de entrada; no se reduce nada.
- Para eso usa el endpoint dedicado de eliminación de marcas de agua. Está ajustado para las superposiciones semitransparentes, repetidas o en mosaico típicas de las marcas de agua, y es el único endpoint que acepta subidas por lotes. Este está pensado para texto opaco: rótulos, marcas de tiempo y etiquetas incrustadas.
- Dos créditos por llamada correcta, y nada en absoluto cuando no se detecta texto. Starter incluye 400 créditos al mes por 9,99 $ y Pro incluye 1.400 por 29,99 $, y los créditos no usados se acumulan mientras tu suscripción siga activa.
- No: la detección es automática y se aplica a toda la imagen. No hay ningún parámetro de región ni de recuadro. Si necesitas una eliminación selectiva, el editor web de ImgGen tiene un borrador de objetos con pincel para ese tipo de trabajo guiado a mano.
- La API acepta archivos JPEG (JPG), PNG y WebP de hasta 25 MB por imagen. Los resultados se devuelven como una imagen codificada en base64 dentro de la respuesta JSON.
- No. La API no guarda estado: no crea ningún proyecto, no guarda ningún archivo ni conserva tu imagen. Tu subida se escribe en un objeto temporal, se procesa y se elimina en cuanto se devuelve la respuesta. Lo único que se conserva es un registro de uso que anota que hubo una llamada y cuántos créditos costó. Tus imágenes nunca se usan para entrenar modelos.
Empezar
Empieza a llamar a la API de eliminación de texto
Una sola clave desbloquea los siete endpoints. Sin marca de agua, con derechos comerciales completos y sin que se almacene nada de lo que envías una vez devuelta la respuesta.
Obtén tu clave de API