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

DesenvolvedoresReferência de API

API REST do TurnitPass

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

REST API v1

Console de referência

Comece pela rota, pelo payload e pela forma da resposta.

A referência completa cobre todos os endpoints abaixo. O console mostra primeiro o contrato de que os desenvolvedores precisam: auth Bearer, entrada JSON, saída medida e checagens de status.

request
POST
fetch('/api/v1/humanize', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tp_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: 'Paste the draft here',
    language: 'en',
    mode: 'reduce-aigc'
  })
})
response
200 OK
{
  "output": "The revised text...",
  "words_used": 142,
  "words_remaining": 2858,
  "status": "succeeded"
}
medidoregistradoJSON
POST/api/v1/humanize
POST/api/v1/paraphrase
POST/api/v1/rewrite
POST/api/v1/detect
POST/api/v1/citation
AuthBearer API key
TransformPOST /humanize
RevisãoPOST /detect
StatusGET /status
POST/api/v1/humanize
v1

Deixa o texto enviado mais natural e reduz sinais de escrita por IA. Modos: reduce-aigc, reduce-both, paraphrase, academic-polish.

POST/api/v1/paraphrase
v1

Reescreve e refina o texto com os modos padrão, fluência, formal, acadêmico, simples, criativo, expandir ou encurtar.

POST/api/v1/rewrite
v1

Endpoint de polimento acadêmico para uma estrutura, tom e fluxo de frases mais limpos.

POST/api/v1/detect
v1

Retorna pontuação estimada, nível de risco, metadados e sinais de escrita para textos colados ou documentos extraídos.

POST/api/v1/citation
v1

Formata um DOI, URL ou citação manual em APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA ou Bluebook. As respostas incluem HTML, texto, BibTeX e RIS.

POST/api/v1/bibliography
v1

Ordena e formata uma lista de citações no estilo solicitado, com saída HTML/texto e exportações em BibTeX e RIS.

GET/api/v1/status
v1

Verifica o nome da chave, saldo de palavras restante, limites de solicitação e último uso.

Parâmetros e opções

Autenticação
Authorization: Bearer tp_your_api_key
Termos protegidos
O campo opcional personal_terms preserva nomes próprios, termos técnicos e marcas durante a revisão.
Limits
Os endpoints de transformação aceitam até 1.000 palavras de entrada. A detecção aceita até 5.000 palavras. Os endpoints de citação possuem limite de taxa, mas não consomem créditos de palavras.
Errors
As respostas JSON incluem os campos error, code e message.

Limites de ritmo e de requisição

Entrada de transformação
humanize/rewrite: 500; paraphrase: 2,000Quality units = CJK characters + other characters / 3, rounded up. Same limits on every plan.
Entrada de detecção
Até 5.000 palavrasVarreduras detector mais longas devem ser fragmentadas antes do envio.
Chaves de API
Até 5 chaves ativasAs chaves podem ser revogadas de forma independente no espaço de trabalho.
Ferramentas de citação
Limite de ritmo separadoChamadas citation e bibliography não gastam créditos de palavras.

Tratamento de erros

As respostas de erro usam JSON com os campos error, code e um message legível quando possível.

error response
JSON
{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}
As credenciais do Stripe e do Google continuam sendo configuração. Superfícies de API, fluxo de auth e persistência já estão implementados para que credenciais live sejam adicionadas sem redesenhar o produto.

Exemplos

Exemplo humanize
JSON
POST /api/v1/humanize
{
  "text": "Cole aqui o rascunho que deseja revisar",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["TurnitPass"]
}

200 OK
{
  "output": "O texto humanizado...",
  "words_used": 142,
  "words_remaining": 2858
}
Exemplo com vários endpoints
JSON
POST /api/v1/paraphrase
{
  "text": "Cole o rascunho que deseja reescrever",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Cole o texto que deseja verificar",
  "language": "en",
  "source_kind": "paste"
}

POST /api/v1/citation
{
  "input": "https://example.com/article",
  "style": "apa"
}

200 OK
{
  "text": "Citação formatada...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}

Próximos passos

Início rápido

Prepare a primeira requisição.

Autenticação

Revise o tratamento das chaves de API.

Histórico

Veja as mudanças recentes da plataforma.

Em seguida, integre ao seu fluxo de trabalho.Continuar lendo