Saltar para o conteúdo
TurnitPass
ProgramadoresAPI v1Obter uma chave de API
Explorar documentação

ProgramadoresDocumentação Técnica

Documentação da API do TurnitPass

Comece com chaves de API, chame rotas de revisão, paráfrase, deteção, citações e bibliografia, e integre o TurnitPass no seu software de escrita.

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 espaço de trabalho e chame as rotas de escrita, deteção e citação com a mesma chave.

02

Autenticação

Os pedidos de desenvolvimento utilizam chaves de API geradas a partir do espaço de trabalho TurnitPass.

03

Referência de API

Referência para rotas autenticadas de revisão, paráfrase, deteção, citação, bibliografia e estado de chaves de API.

04

Histórico

Alterações recentes na plataforma para o humanizador de IA, detetor, ferramentas de escrita, faturação e APIs.

Passo seguinte

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.

API

Rotas principais

Rever

POST/api/v1/humanize

Revê texto assistido por IA mantendo o significado original.

Parafrasear

POST/api/v1/paraphrase

Reescreve e refina textos em múltiplos modos.

Detetar

POST/api/v1/detect

Devolve estimativas de sinais de IA e notas de revisão.

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 no seu fluxo de trabalho.Continuar a ler