Docs menuAPIリファレンス

API ReferenceTyped request and response

APIリファレンス

TurnitPass REST API

認証が必要な文章調整、言い換え、AIチェック、引用、参考文献、APIキー状態確認のリファレンス。

Reference console

Start with the route, payload, and response shape.

The full reference covers every endpoint below. The console shows the contract developers need first: Bearer auth, JSON input, metered output, and status checks.

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"
}

meteredloggedJSON

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

ReviewPOST /detect

StatusGET /status

POST/api/v1/humanize

送信されたテキストを調整し、AIらしい表現を見直しやすくします。モード：reduce-aigc、reduce-both、paraphrase、academic-polish。

POST/api/v1/paraphrase

スタンダード、流暢、フォーマル、アカデミック、シンプル、クリエイティブ、拡張、短縮モードでテキストの書き換えや調整を行います。

POST/api/v1/rewrite

構成、語調、文の流れを整えるための学術推敲機能。

POST/api/v1/detect

貼り付けられたテキストや抽出された文書に対して、AI生成の可能性の目安、メタデータ、見直しポイントを返します。

POST/api/v1/citation

DOI、URL、または手動引用情報を APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA, Bluebook 形式で整形します。レスポンスにはHTML、プレーンテキスト、BibTeX、RISが含まれます。

POST/api/v1/bibliography

指定されたスタイルで引用リストを並べ替えて整形します。出力はHTML/テキスト形式で、BibTeXとRISのエクスポートに対応しています。

GET/api/v1/status

キーのラベル、残りワード数、リクエスト制限を確認します。

Parameters and options

認証

Authorization: Bearer tp_your_api_key

保持する用語

任意の personal_terms 配列を使用すると、英語の文章調整中に固有名詞、技術用語、ブランド名の表記を保持できます。

利用制限

文章調整機能は、一度に最大1,000ワードまで入力可能です。AIチェックは最大5,000ワードまで可能です。引用機能には個別の利用制限がありますが、ワード数は消費されません。

エラー

JSONレスポンスには error、code、message フィールドが含まれます。

Rate limits and request limits

Transform input

Up to 1,000 wordsApplies to humanize, paraphrase, and rewrite endpoints.

Detection input

Up to 5,000 wordsLonger detector scans should be chunked before submission.

API keys

Up to 5 active keysKeys can be revoked independently from the workspace.

Citation tools

Rate-limited separatelyCitation and bibliography calls do not spend word credits.

Error handling

Error responses use JSON with error,code, and human-readable message fields where possible.

error response

JSON

{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}

The Stripe and Google credentials are configuration points. The API surfaces, auth flow, and persistence are implemented so live credentials can be added without redesigning the product.

Examples

Humanize example

JSON

POST /api/v1/humanize
{
  "text": "調整したいAI補助の下書きを貼り付けます",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["固有名詞"]
}

200 OK
{
  "output": "調整されたテキスト...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "書き換えたい下書きを貼り付けます",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "確認したい下書きを貼り付けます",
  "language": "en",
  "source_kind": "paste"
}

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

200 OK
{
  "text": "フォーマットされた引用文...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}

Next steps

クイックスタート

Set up the first request.

認証方法

Review API key handling.

更新履歴

See recent platform changes.

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' }) })

Parameters and options

認証

Authorization: Bearer tp_your_api_key

保持する用語

任意の personal_terms 配列を使用すると、英語の文章調整中に固有名詞、技術用語、ブランド名の表記を保持できます。

利用制限

エラー

JSONレスポンスには error、code、message フィールドが含まれます。

Rate limits and request limits

Transform input

Up to 1,000 wordsApplies to humanize, paraphrase, and rewrite endpoints.

Detection input

Up to 5,000 wordsLonger detector scans should be chunked before submission.

API keys

Up to 5 active keysKeys can be revoked independently from the workspace.

Citation tools

Rate-limited separatelyCitation and bibliography calls do not spend word credits.

Error handling

Error responses use JSON with error,code, and human-readable message fields where possible.

error response

JSON

{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}

The Stripe and Google credentials are configuration points. The API surfaces, auth flow, and persistence are implemented so live credentials can be added without redesigning the product.

Examples

Humanize example

JSON

POST /api/v1/humanize
{
  "text": "調整したいAI補助の下書きを貼り付けます",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["固有名詞"]
}

200 OK
{
  "output": "調整されたテキスト...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "書き換えたい下書きを貼り付けます",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "確認したい下書きを貼り付けます",
  "language": "en",
  "source_kind": "paste"
}

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

200 OK
{
  "text": "フォーマットされた引用文...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}