本文へ移動
TurnitPass
開発者API v1
API キーを発行
ドキュメントを見る

開発者APIリファレンス

TurnitPass REST API

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

REST API v1

リファレンスコンソール

まず経路、ペイロード、応答形を確認します。

以下の全エンドポイントを扱います。コンソールは最初に必要な契約を示します。Bearer 認証、JSON 入力、計量出力、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"
}
計量記録JSON
POST/api/v1/humanize
POST/api/v1/paraphrase
POST/api/v1/rewrite
POST/api/v1/detect
POST/api/v1/citation
認証Bearer API key
改稿POST /humanize
確認POST /detect
状態GET /status
POST/api/v1/humanize
v1

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

POST/api/v1/paraphrase
v1

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

POST/api/v1/rewrite
v1

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

POST/api/v1/detect
v1

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

POST/api/v1/citation
v1

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

POST/api/v1/bibliography
v1

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

GET/api/v1/status
v1

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

パラメータとオプション

認証
Authorization: Bearer tp_your_api_key
保持する用語
任意の personal_terms 配列を使用すると、英語の文章調整中に固有名詞、技術用語、ブランド名の表記を保持できます。
利用制限
Humanize/rewrite: 500 quality units; paraphrase: 2,000 quality units. Detection: 5,000 word units and 30,000 characters, with a separate daily scan allowance. Citations are rate-limited and do not spend writing credits.
エラー
JSONレスポンスには error、code、message フィールドが含まれます。

レート制限とリクエスト上限

改稿入力
humanize/rewrite: 500; paraphrase: 2,000Quality units = CJK characters + other characters / 3, rounded up. Same limits on every plan.
検出入力
最大 5,000 語より長い検出は提出前に分割してください。
API キー
有効 5 件までワークスペースから個別に失効できます。
引用ツール
別レート制限citation と bibliography は語数を消費しません。

エラー処理

エラー応答は可能な限り error、code、読みやすい message を含む JSON です。

error response
JSON
{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}
Stripe と Google の資格情報は設定項目です。API、認証、永続化は実装済みなので、本番資格情報を足しても製品設計を変えずに済みます。

例

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

200 OK
{
  "output": "調整されたテキスト...",
  "words_used": 142,
  "words_remaining": 2858
}
複数エンドポイントの例
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..."
}

次のステップ

クイックスタート

最初のリクエストを用意します。

認証方法

API キーの扱いを確認します。

更新履歴

最近のプラットフォーム変更を見ます。

次に、ワークフローへ接続します。続きを読む