FAQ
O que é o ChunkChef?
Uma API de processamento de documentos: você envia arquivos e prompts de texto e recebe de volta o texto reconhecido e as respostas do modelo para cada arquivo. Descompactação de arquivos, conversão, OCR e a chamada ao modelo acontecem do nosso lado.
Como o ChunkChef se diferencia de um OCR comum ou de um conversor?
O ChunkChef combina descompactação, conversão, OCR e a chamada ao modelo de linguagem em um único job assíncrono que roda na sua chave de provedor. Não é um conversor de formatos nem OCR puro.
O que é BYOK e por que é vantajoso?
Bring Your Own Key — você conecta sua própria chave de provedor de modelo. Você paga o provedor diretamente pelos tokens e OCR pela taxa dele; o ChunkChef não adiciona markup.
Pelo que estou pagando ao ChunkChef?
Pela ferramenta: orquestração, confiabilidade (retentativas, recuperação), suporte a formatos e arquivos, desenvolvimento contínuo e suporte. Tokens e OCR são pagos ao provedor pela sua chave.
Posso testar de graça?
Sim. Cadastre-se, crie uma chave e envie jobs dentro do plano gratuito — sem cartão de crédito.
Posso testar o ChunkChef sem uma conta?
Sim — o playground permite enviar um arquivo e rodar um prompt pronto sem cadastro. Ele é mais limitado que uma conta real: poucas execuções por sessão, um orçamento diário compartilhado e um limite de 10 MB por arquivo. Crie uma conta gratuita na tela de resultado para ver o resultado completo e continuar sem essas limitações.
O que acontece com meus documentos e chaves BYOK?
Os três segredos (neural.apiKey, ocr.providerKey e webhookSecret) nunca são armazenados em texto simples; os artefatos criptografados e seus arquivos são excluídos junto com o job (~7 dias) — veja "Segurança e dados" para detalhes.
Quais formatos são suportados?
21 formatos: PDF, DOC/DOCX, XLS/XLSX, PPT/PPTX, RTF, TXT, ODT, imagens (JPG, PNG, TIFF, HEIC) e arquivos ZIP/7Z/RAR/EML/MSG — consulte "Formatos suportados".
Existem limites?
Sim — no tamanho do job, no tamanho da resposta do conversor, em timeouts e no tamanho do prompt. Veja "Limites".
Tenho garantia de JSON válido?
Por padrão, seu prompt e o modelo escolhido determinam a estrutura da saída — não há validação no lado do servidor. Passe `responseSchema` para ativá-la: o ChunkChef então valida a resposta e reporta `schemaValid`/`schemaErrors` (apenas para arquivos de um único chunk).
Qual modelo escolher?
Depende da tarefa e do orçamento. Compare a inteligência e o preço por token dos modelos no comparativo de LLM e defina-o na configuração do job.
Posso forçar o OCR em vez da extração híbrida?
Sim — defina `extractionMode` como `EXTRACTION_MODE_OCR_ALWAYS` em um job BYOK, ou defina um padrão de conta no painel → Configurações. O padrão, `EXTRACTION_MODE_HYBRID` ("Extração híbrida otimizada"), deixa o conversor escolher por arquivo.
Posso obter do modelo um JSON validado?
Sim — passe `responseSchema` (um JSON Schema autocontido) ao criar o job. O ChunkChef valida a resposta contra ele e reporta `schemaValid`/`schemaErrors` por arquivo (apenas para arquivos de um único chunk); uma resposta não conforme coloca o job em `JOB_STATUS_PARTIAL` em vez de rejeitá-la.
Como sei se posso confiar nos valores extraídos?
Defina `consensus.mode` (requer `responseSchema`) para que o ChunkChef execute a extração 2, 3 ou 5 vezes e vote em cada campo. Você recebe uma pontuação de concordância (`minAgreement`) e uma lista exata do que o modelo hesitou — uma verificação de alucinação embutida, ao custo de k vezes os tokens na sua própria chave.