Convertir PDF a escala de grises página por página
Cuatro páginas marcadas en color, en gris, en CMYK y en gris vuelven como cuatro páginas en escala de grises, con un recuento que muestra que solo 2 necesitaban cambiar. Úselo para planificar una conversión o detectar archivos mixtos. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Páginas
- color, grayscale, CMYK, grayscale
- Páginas
- grayscale, grayscale, grayscale, grayscale
- Número de páginas
- 4
- Páginas modificadas
- 2
Convierta un PDF a escala de grises durante la etapa de metadatos de página mediante una operación pequeña y determinista. Indique el modo de color actual de cada página en el orden del documento y recibirá una lista equivalente donde todas quedan marcadas en escala de grises. El resultado también informa el total de páginas y cuántos modos cambiaron exactamente, para distinguir una conversión completa de un documento que ya estaba preparado. Los documentos vacíos se rechazan con un error de entrada claro.
Represente el PDF como una secuencia de modos de página
Esta capacidad trabaja con la información del modo de color por página producida por una etapa previa de inspección o procesamiento de PDF. Proporcione una cadena no vacía por cada página y conserve el mismo orden del documento. Por ejemplo, un PDF de tres páginas podría representarse con color, escala de grises y cmyk.
La salida conservará tres posiciones en ese orden, pero todas quedarán establecidas como grayscale. Como la operación actúa sobre descriptores de página y no sobre datos binarios cargados, resulta predecible, rápida y sencilla de insertar entre el análisis del PDF y una fase posterior de renderizado o exportación. La entrada debe incluir al menos una página.
Si falta el campo pages, la lista está vacía, el valor no es una lista o algún modo está vacío, la solicitud se rechaza en lugar de interpretarse como un documento válido de cero páginas. Esta validación estricta hace visibles los fallos del flujo e impide confundir la ausencia de resultados del analizador con una conversión correcta. El orden nunca se clasifica, elimina ni modifica.
Integre el resultado en un flujo de procesamiento PDF
El resultado está pensado para procesos que separan la inspección del PDF, la planificación de transformaciones y el renderizado del archivo. Primero, un analizador o sistema documental determina el modo actual de cada página. Después, esta capacidad normaliza el plan e informa cuántos descriptores necesitan cambiar.
Esta capacidad no abre, rasteriza, recolorea ni devuelve un PDF binario; transforma la descripción de modos por página facilitada por quien llama. Ese límite permite utilizarla en el navegador y en automatizaciones deterministas, pero si usted necesita modificar los píxeles deberá enviar el plan a un renderizador PDF apropiado. El recuento sirve para mostrar una vista previa como “12 de 30 páginas cambiarán”, comprobar que un documento supuestamente convertido ya no contiene modos de color o detectar archivos fuente mixtos inesperados.
Qué puede hacer con ella
Preparar un plan de conversión
Normalice los modos detectados antes de enviar una lista ordenada de destinos en escala de grises al renderizador PDF.
Auditar documentos de modos mixtos
Cuente cuántas páginas de un PDF recibido todavía no están marcadas en escala de grises.
Verificar una conversión anterior
Confirme que un documento procesado no requiere más cambios sin aceptar como válido un resultado vacío.
Preguntas frecuentes
¿Devuelve un archivo PDF convertido?
No. Normaliza los descriptores de modo de color proporcionados. Un renderizador PDF posterior debe aplicar el modo solicitado a los píxeles y recursos.
¿Cambia el orden de las páginas?
No. El arreglo pages devuelto conserva exactamente la longitud y el orden de la entrada.
¿Una página escrita como GRAYSCALE o con espacios de más cuenta como cambiada?
No. Se ignoran las mayúsculas y los espacios alrededor del valor, así que esas páginas se reconocen como ya en escala de grises. Solo modos como color, rgb, cmyk o monochrome cuentan como cambio.
¿Qué significa un resultado con cero páginas cambiadas?
Que la lista era válida y todas las páginas ya estaban en escala de grises, así que no hubo nada que cambiar. Nunca significa que el documento estuviera vacío: una lista vacía se rechaza con un mensaje claro.
¿Para qué sirve el recuento de páginas cambiadas?
Para mostrar un aviso previo como «cambiarán 12 de 30 páginas», confirmar que un documento ya convertido no conserva páginas en color o señalar archivos que mezclan páginas en color y en gris.
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
¿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.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/pdf/grayscale \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"pages":["color","grayscale","cmyk"]}'const res = await fetch("https://api.kit.forhosting.com/pdf/grayscale", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pages": [
"color",
"grayscale",
"cmyk"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/grayscale",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pages": [
"color",
"grayscale",
"cmyk"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/grayscale", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pages":["color","grayscale","cmyk"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pages":["color","grayscale","cmyk"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/grayscale", 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
{
"pages": [
"color",
"grayscale",
"cmyk"
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.grayscale",
"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 | 25 |
max_pages | 200 |
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
Interprete el recuento de páginas modificadas
Cada elemento válido de entrada se convierte en el valor canónico exacto grayscale. Esta diferencia ayuda cuando una conversión ya ocurrió en una etapa anterior o cuando llegan documentos mixtos desde varias fuentes. Un valor intermedio identifica un documento de modos combinados. El campo pages_changed cuenta únicamente los modos cuyo valor, una vez retirados los espacios y sin distinguir mayúsculas, todavía no era grayscale. Por ello, grayscale, GRAYSCALE y el mismo término rodeado de espacios se reconocen como páginas ya preparadas, mientras que color, rgb, cmyk, monochrome o cualquier otro modo no vacío se contabiliza como cambio. El campo page_count siempre coincide con la cantidad de elementos recibidos y el arreglo pages devuelto mantiene esa longitud. Un pages_changed igual a cero significa que la petición era válida pero ninguna página necesitaba cambiar; no significa que la entrada estuviera vacía. Si coincide con page_count, todas las páginas cambiaron. El cálculo no utiliza red, reloj, azar, reglas regionales ni estado mutable, por lo que una misma entrada genera siempre el mismo JSON.
Integre el resultado en un flujo de procesamiento PDF
Finalmente, un motor PDF puede utilizar la lista ordenada devuelta como modo de destino y registrar pages_changed para informes, validaciones o métricas operativas. El uso automatizado cuesta $0.002 por solicitud y no declara un cargo adicional por página.
Preguntas técnicas
¿Qué cuenta pages_changed?
Cuenta cada página válida cuyo valor, tras retirar espacios y sin distinguir mayúsculas, aún no era grayscale.
¿Qué ocurre si todas las páginas ya están en escala de grises?
La petición se completa, todas las páginas devueltas permanecen como grayscale y pages_changed vale cero.
¿Puedo enviar una lista pages vacía?
No. La descripción de un PDF debe contener al menos un modo de página; una entrada ausente o vacía genera invalid_input.
¿Cuánto cuesta una solicitud automatizada?
El precio publicado es $0.002 por solicitud, sin cargo adicional por página.