Pular para o conteúdo
TurnitPass
DesenvolvedoresAPI v1Obter uma chave de API
Navegar na documentação

DesenvolvedoresDocumentação Técnica

Documentação da API do TurnitPass

Comece com chaves de API, chame os endpoints de humanização, paráfrase, detecção, citações e bibliografia, e integre o TurnitPass ao seu próprio software de redação.

REST API v1

One request

Quick example

Envie texto ao endpoint humanizer com uma chave de API Bearer. A resposta devolve o resultado transformado, as palavras usadas e o saldo restante do titular da chave.

curl
POST /api/v1/humanize
curl -X POST https://turnitpass.com/api/v1/humanize \
  -H "Authorization: Bearer tp_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text":"Paste your draft here","language":"en","mode":"revise"}'
response
200 OK
{
  "output": "Your humanized text...",
  "words_used": 6,
  "words_remaining": 249994
}
O TurnitPass também expõe os endpoints paraphrase, rewrite, detector, citation, bibliography e status no mesmo fluxo de chave de API.

Route map

Explore the docs

01

Início rápido

Crie uma chave de API no painel e chame os endpoints de redação, detecção e citação com o mesmo token Bearer.

02

Autenticação

As solicitações de desenvolvimento utilizam chaves de API geradas a partir do painel do TurnitPass.

03

Referência de API

Referência para endpoints autenticados de humanização, paráfrase, detecção, citação, bibliografia e status de chaves de API.

04

Histórico

Alterações recentes na plataforma para o humanizador de IA, detector, ferramentas de escrita, faturamento e APIs.

Próximo passo

Request lifecycle

Toda chamada à API do TurnitPass segue o mesmo caminho: autenticar a chave, validar o payload, executar o fluxo de escrita ou citação, medir o uso e devolver uma forma de resposta que o produto possa armazenar.

1

Autenticar a chave de API

Envie uma chave gerada no espaço de trabalho. Chaves revogadas, malformadas ou ausentes falham antes do processamento do texto.

2

Validar texto, idioma e limites

Requisições de transformação aplicam faixas de palavras, as de detector aplicam limites de varredura maiores e as de citation validam estilo e fonte.

3

Executar o fluxo

As rotas humanize, paraphrase, rewrite, detect, citation e bibliography reutilizam o mesmo comportamento de servidor das ferramentas públicas.

4

Registrar o uso e devolver o resultado

Chamadas bem-sucedidas devolvem a saída mais metadados de uso: palavras usadas, saldo restante, status ou exportações de citação formatadas.

Superfície da API

Endpoints principais

Humanizar

POST/api/v1/humanize

Reduz os sinais de escrita por IA enquanto preserva o significado original.

Parafrasear

POST/api/v1/paraphrase

Reescreve e refina textos em múltiplos modos.

Detectar

POST/api/v1/detect

Retorna pontuação estimada, nível de risco e sinais de escrita.

Citações

POST/api/v1/citation

Formata metadados de fontes DOI, URL ou inseridos manualmente.

Production checklist

Chamadas no servidor
Nunca exponha chaves de API no clienteChame o TurnitPass a partir do backend, worker, fila ou server action protegida.
Comportamento de retry
Repita falhas de rede, não de validaçãoTrate respostas 4xx como problemas de usuário ou payload e reserve retries para erros 5xx ou de rede transitórios.
Orçamento de palavras
Mostre o saldo antes de fluxos pesadosUse o endpoint status para decidir se enfileira, pede upgrade ou divide o documento.
Cobrança
Segredos do Stripe são a configuração finalCheckout, portal e webhook já estão ligados; chaves live e price IDs ficam para o deploy.
Em integrações de produto, use uma chave TurnitPass por ambiente. Produção, staging e desenvolvimento local devem ser revogáveis de forma independente.
Em seguida, integre ao seu fluxo de trabalho.Continuar lendo