ForHosting KIT · Imágenes

Convierta el brillo de una imagen en arte ASCII

Transforme una cuadrícula rectangular de muestras de brillo en escala de grises en arte ASCII limpio y reproducible.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Indique enteros desde 0 para negro hasta 255 para blanco y elija una rampa de caracteres ordenada de oscuro a claro. El conversor asigna cada muestra a la posición más cercana de la rampa y conserva la cuadrícula como líneas de texto. Resulta útil para vistas previas en terminal, renderizadores de texto, programación creativa, enseñanza del procesamiento de imágenes y flujos que ya calculan promedios de píxeles o celdas.

Prepare una cuadrícula de brillo adecuada

Comience con una matriz rectangular: cada matriz interior representa una línea de salida y cada valor, una celda de carácter. Las muestras deben ser enteros entre 0 y 255; 0 es oscuridad total, 255 es brillo total y los valores intermedios expresan tonos de gris. Si parte de una fotografía de alta resolución, redúzcala antes de usar el conversor. Promedie un bloque de píxeles para cada posición de carácter, pues convertir cada píxel en un carácter suele producir un resultado inmenso y acentúa la diferencia de proporciones entre píxeles y glifos. Mantenga todas las filas con la misma longitud. Para una terminal suelen bastar entre 40 y 120 columnas y menos filas, ya que los caracteres suelen ser más altos que anchos. Al recibir datos de brillo en vez de un archivo, la herramienta le permite decidir previamente el tamaño, el recorte, la conversión de color, la transparencia y el contraste. Con esas decisiones fijadas, una misma cuadrícula siempre genera el mismo texto.

Elija y comprenda la rampa ASCII

Escriba la rampa desde el carácter que representará la muestra más oscura hasta el que representará la más clara. Una rampa como <code>@%#*+=-:. </code> avanza desde signos visualmente densos hasta un espacio final: las zonas negras quedan marcadas y las blancas se funden con el fondo. Invierta el orden si desea una interpretación clara sobre fondo oscuro, o use <code>#.</code> para un resultado binario muy contrastado. Cada carácter Unicode cuenta como una posición, incluidos espacios y emoji, aunque los caracteres monoespaciados habituales mantienen mejor la alineación. Para cada muestra, el conversor distribuye el intervalo 0–255 entre todas las posiciones y redondea a la más cercana. Los extremos son exactos: 0 selecciona siempre el primer carácter y 255, el último. Puede repetir caracteres para ensanchar deliberadamente una franja tonal. Una rampa vacía se rechaza. Tenga presente que un espacio final es significativo aunque apenas se vea en un formulario o visor JSON.

Utilice el texto y los metadatos devueltos

El resultado contiene <code>art</code>, una cadena unida mediante saltos de línea que puede enviar directamente a una terminal, un archivo de texto, un registro o un bloque de código. También ofrece <code>lines</code> como matriz, más cómoda cuando un programa necesita añadir sangría, bordes, color ANSI o números de línea sin volver a dividir el texto. Los recuentos de filas y columnas permiten comprobar las dimensiones, y <code>ramp_length</code> indica cuántos caracteres Unicode participaron. No se aplica tramado aleatorio, por lo que valores cercanos pueden compartir carácter cuando la rampa es corta; el comportamiento es intencional y reproducible. Si necesita tramado, aplique antes una difusión de error determinista o un patrón ordenado y envíe la cuadrícula resultante. Muestre el arte con una fuente monoespaciada y conserve los espacios. En HTML, insértelo como texto en un elemento preformateado, nunca como marcado, especialmente si la rampa contiene corchetes angulares o ampersands.

Cree vistas previas para terminal

Convierta celdas de gris reducidas en texto compacto para shells, registros y herramientas de línea de comandos.

Explique la cuantización del brillo

Muestre cómo valores de gris aparentemente continuos se convierten en bandas tonales definidas por una rampa finita.

Produzca gráficos de texto deterministas

Genere recursos ASCII reproducibles para documentación, pruebas, interfaces retro o proyectos de programación creativa.

¿En qué orden se escribe la rampa?

Ordene los caracteres desde el símbolo para brillo 0 hasta el símbolo para brillo 255. Una rampa de denso a ligero crea el estilo habitual de tinta oscura sobre fondo claro.

¿Qué ocurre si la rampa está vacía?

La solicitud falla con un error de entrada no válida porque no existe ningún carácter que pueda representar el brillo.

¿Se aceptan valores decimales de brillo?

No. Cada muestra debe ser un entero entre 0 y 255, ambos incluidos, para que el contrato y el resultado sean reproducibles.

¿El conversor cambia el tamaño de una imagen?

No. Convierte una cuadrícula rectangular ya preparada. Redimensione la fuente y calcule los valores de gris antes de enviar la solicitud.

¿Cuánto cuesta una solicitud de API?

Cada solicitud de API cuesta $0.002. También puede ejecutar gratuitamente la misma conversión determinista en el navegador.

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.

POSThttps://api.kit.forhosting.com/image/ascii-art-map

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/image/ascii-art-map \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"samples":[[0,64,128,192,255],[255,192,128,64,0]],"ramp":"@%#*+=-:. "}'
{
  "samples": [
    [
      0,
      64,
      128,
      192,
      255
    ],
    [
      255,
      192,
      128,
      64,
      0
    ]
  ],
  "ramp": "@%#*+=-:. "
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.ascii_art_map",
  "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.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_mb15
max_megapixels12
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →