ForHosting KIT · PDF e documentos

Converter PDF para tons de cinza em todas as páginas

Quatro páginas marcadas como cor, cinza, CMYK e cinza voltam como quatro páginas em tons de cinza, com uma contagem que mostra que só 2 precisavam mudar. Use para planejar uma conversão ou achar arquivos mistos. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Páginas: color, grayscale, CMYK, grayscale

Você obtém

Páginas: grayscale, grayscale, grayscale, grayscale
Contagem de páginas: 4
Páginas alteradas: 2

Converta um PDF para tons de cinza na etapa de metadados das páginas com uma operação pequena e determinística. Informe o modo de cor atual de cada página na ordem do documento e receba uma lista correspondente em que todas ficam marcadas como grayscale. O resultado também mostra o total de páginas e quantos modos foram alterados, distinguindo uma conversão completa de um arquivo que já estava preparado. Documentos vazios são recusados com uma mensagem de entrada clara.

Represente o PDF como uma sequência de modos de página

Esta capacidade utiliza as informações de modo de cor por página produzidas por uma etapa anterior de inspeção ou processamento de PDF. Forneça uma string não vazia para cada página e mantenha a mesma ordem do documento. Por exemplo, um PDF de três páginas pode ser representado por color, grayscale e cmyk.

A saída conservará três posições nessa ordem, mas todas serão definidas como grayscale. Como a operação trata descritores de página, e não dados binários enviados, ela é previsível, rápida e fácil de inserir entre a análise do PDF e uma etapa posterior de renderização ou exportação. A entrada precisa conter pelo menos uma página.

Se o campo pages estiver ausente, a lista estiver vazia, o valor não for uma lista ou algum modo estiver em branco, a solicitação será recusada em vez de ser considerada um documento válido com zero páginas. Essa validação rigorosa torna visíveis os erros do fluxo e impede que a ausência de saída do analisador pareça uma conversão bem-sucedida. A ordem das páginas nunca é classificada, deduplicada ou alterada.

Use o resultado em um fluxo de processamento de PDF

O resultado foi criado para fluxos que separam a inspeção do PDF, o planejamento da transformação e a renderização do arquivo. Primeiro, um analisador ou sistema documental identifica o modo atual de cada página. Em seguida, esta capacidade normaliza o plano e informa quantos descritores precisam ser alterados.

Esta capacidade não abre, rasteriza, recolore nem devolve um PDF binário; ela transforma a descrição de modos por página fornecida por você. Esse limite permite o uso no navegador e em automações determinísticas, mas quem precisa alterar pixels ainda deve encaminhar o plano para um renderizador de PDF adequado. A contagem pode alimentar uma prévia como “12 de 30 páginas serão alteradas”, confirmar que um documento supostamente convertido não contém mais modos coloridos ou sinalizar arquivos de origem mistos inesperados.

Casos de uso

Preparar um plano de conversão

Normalize os modos detectados antes de enviar uma lista ordenada de destinos em tons de cinza ao renderizador de PDF.

Auditar documentos com modos mistos

Conte quantas páginas de um PDF recebido ainda não estão marcadas como grayscale.

Verificar uma conversão anterior

Confirme que um documento processado não exige mais alterações sem aceitar um resultado vazio.

Perguntas frequentes

Esta capacidade devolve um arquivo PDF convertido?

Não. Ela normaliza os descritores de modo de cor fornecidos. Um renderizador posterior deve aplicar o modo solicitado aos pixels e recursos.

A ordem das páginas é modificada?

Não. O array pages retornado conserva exatamente o tamanho e a ordem da entrada.

Uma página escrita como GRAYSCALE ou com espaços sobrando conta como alterada?

Não. Maiúsculas e espaços em volta do valor são ignorados, então essas páginas são reconhecidas como já em tons de cinza. Só modos como color, rgb, cmyk ou monochrome contam como alteração.

O que significa um resultado com zero páginas alteradas?

Que a lista era válida e todas as páginas já estavam em tons de cinza, então não havia nada a mudar. Nunca significa documento vazio: uma lista vazia é recusada com uma mensagem clara.

Para que serve a contagem de páginas alteradas?

Para mostrar uma prévia como “12 de 30 páginas vão mudar”, confirmar que um documento já convertido não tem mais páginas coloridas ou sinalizar arquivos que misturam páginas coloridas e em cinza.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/pdf/grayscale

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

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)

Exemplo de requisição

{
  "pages": [
    "color",
    "grayscale",
    "cmyk"
  ]
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.grayscale",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`max_mb`	25
`max_pages`	200

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

Entenda a contagem de páginas alteradas

Cada item válido de entrada se transforma no valor canônico exato grayscale. Essa diferença é útil quando a conversão já ocorreu em uma etapa anterior ou quando documentos mistos chegam de diversas fontes. Valores intermediários indicam documentos com modos mistos. O campo pages_changed conta somente os modos cujo valor, depois de remover espaços e ignorar diferenças entre maiúsculas e minúsculas, ainda não era grayscale. Assim, grayscale, GRAYSCALE e o mesmo termo cercado por espaços são reconhecidos como páginas já prontas, enquanto color, rgb, cmyk, monochrome ou qualquer outro modo não vazio é contabilizado como alteração. O campo page_count sempre corresponde à quantidade de itens fornecidos, e o array pages retornado mantém esse mesmo tamanho. Um pages_changed igual a zero significa que a solicitação era válida, mas nenhuma página precisava mudar; não significa que a entrada estava vazia. Quando o valor é igual a page_count, todas as páginas mudaram. O cálculo não usa rede, relógio, aleatoriedade, regras regionais nem estado mutável, portanto uma entrada idêntica sempre gera o mesmo JSON.

Use o resultado em um fluxo de processamento de PDF

Depois, um mecanismo de PDF pode usar a lista ordenada retornada como modo de destino e registrar pages_changed em relatórios, validações ou métricas operacionais. O uso automatizado custa US$ 0,002 por solicitação, sem cobrança adicional por página declarada para esta capacidade.

Perguntas técnicas

O que pages_changed contabiliza?

Conta cada página válida cujo valor, após remover espaços e ignorar maiúsculas e minúsculas, ainda não era grayscale.

O que acontece se todas as páginas já estiverem em tons de cinza?

A solicitação é concluída, todas as páginas retornadas permanecem como grayscale e pages_changed vale zero.

Posso enviar um array pages vazio?

Não. A descrição de um PDF precisa conter pelo menos um modo de página; uma entrada vazia ou ausente retorna invalid_input.

Quanto custa uma solicitação automatizada?

O preço publicado é US$ 0,002 por solicitação, sem cobrança adicional por página.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Represente o PDF como uma sequência de modos de página

Use o resultado em um fluxo de processamento de PDF

Casos de uso

Preparar um plano de conversão

Auditar documentos com modos mistos

Verificar uma conversão anterior

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Limites

Erros

Notas técnicas

Entenda a contagem de páginas alteradas

Use o resultado em um fluxo de processamento de PDF

Perguntas técnicas

obrigado