ForHosting KIT · Documentos y PDF

Cree una cuadrícula de miniaturas de páginas PDF

Convierta el número de páginas de un PDF y la cantidad elegida de columnas en una especificación exacta de cuadrícula.

● BetaGratis · en su navegador

Úselo desde WebAPIEmailTelegramApp pronto

La calculadora devuelve las filas necesarias, el total de celdas y cuántas miniaturas ocupan la última fila. Resulta útil para crear visores PDF, hojas de contacto, paneles de revisión, planes de impresión o interfaces que deban reservar un espacio previsible antes de disponer de las imágenes de cada página.

Planifique la cuadrícula antes de generar las miniaturas

Una interfaz de miniaturas PDF suele necesitar su estructura antes de que termine la generación de imágenes. Indique el número de páginas y las columnas deseadas, y esta calculadora devolverá de inmediato la cantidad exacta de filas. También informa de la capacidad total del rectángulo y de las miniaturas reales que ocupan la última fila. Con estos tres valores, usted puede reservar un espacio estable, crear marcadores temporales, dimensionar el área de desplazamiento o repartir el trabajo sin abrir ni modificar el PDF. Por ejemplo, un documento de 23 páginas distribuido en cinco columnas requiere cinco filas, ofrece 25 celdas y sitúa tres miniaturas en la fila final. El cálculo usa aritmética entera determinista. La función no genera imágenes, no examina los bytes del PDF, no elige tamaños ni aplica estilos visuales; resuelve exclusivamente la planificación de la cuadrícula, sin red, cargas de archivos ni supuestos ocultos de presentación.

Interprete correctamente las filas, las celdas y la fila final

El valor rows es el menor número entero de filas capaz de contener todas las páginas con las columnas solicitadas. Total cells multiplica filas por columnas y representa la capacidad del rectángulo completo, incluidas las posiciones vacías después de la última miniatura. Last-row fill cuenta las miniaturas reales de la última fila. Si el número de páginas es divisible exactamente por las columnas, la fila final está llena y su ocupación equivale a las columnas; nunca se devuelve cero. Así, el resultado sirve directamente para bucles, etiquetas accesibles y estilos. Ambos datos de entrada deben ser enteros positivos seguros. Los valores fraccionarios, ausentes, textuales, infinitos, nulos o negativos se rechazan sin redondearlos ni convertirlos. En particular, menos de una columna no permite colocar páginas en una cuadrícula finita. Este contrato estricto permite detectar configuraciones erróneas en su origen.

Aplique el resultado en visores y flujos documentales

En un visor, use las filas para estimar la altura de la galería a partir del alto de miniatura y la separación, mientras que las celdas totales pueden alimentar una lista fija de marcadores. Compare la capacidad con el número de páginas para conocer los huecos, aunque la ocupación final suele ser la referencia más clara para estilizar la última fila. En un panel generado por servidor, estos valores permiten dividir páginas en lotes previsibles o crear referencias de paginación antes de que terminen los procesos de imagen. Una hoja de contacto puede elegir la orientación del papel según las filas, y las pruebas pueden verificar casos límite como una sola página, una cuadrícula completa o una última fila con una miniatura. Como la función recibe metadatos y no el archivo PDF, usted debe obtener el número fiable de páginas por otro medio. Cada cálculo mediante API cuesta $0.002; el navegador ofrece el mismo cálculo puro de forma interactiva.

Qué puede hacer con ella

Reserve la galería de un visor PDF

Calcule las filas antes de que terminen las miniaturas para evitar cambios bruscos en el diseño del visor.

Prepare una hoja de contacto

Determine la capacidad rectangular y la ocupación final para el número de columnas seleccionado.

Pruebe puntos de adaptación

Compare resultados exactos con distintas columnas y compruebe los límites mediante pruebas automatizadas de interfaz.

Preguntas frecuentes

¿Cuánto cuesta un cálculo?

Cada cálculo mediante API cuesta $0.002. El cálculo interactivo también está disponible en esta página.

¿total_cells siempre equivale a page_count?

No. Las celdas totales representan la capacidad del rectángulo completo y pueden incluir huecos en una última fila parcial.

¿Qué ocurre cuando la última fila está completa?

Su ocupación equivale al número de columnas. Una fila final completa se indica como llena, no como cero.

¿Puede haber cero columnas?

No. Las columnas deben ser un entero positivo; cualquier valor inferior a 1 produce un error de entrada no válida.

¿Esta función lee o genera el PDF?

No. Solo utiliza el número de páginas indicado y devuelve cifras de diseño; nunca recibe bytes del PDF ni crea imágenes.

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

POSThttps://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout

¿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/page-thumbnail-grid-layout \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_count":23,"columns":5}'

const res = await fetch("https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "page_count": 23,
    "columns": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "page_count": 23,
    "columns": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"page_count":23,"columns":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"page_count":23,"columns":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout", 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

{
  "page_count": 23,
  "columns": 5
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.page_thumbnail_grid_layout",
  "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

Por solicitud$0.002

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.

Ver la documentación completa del KIT →