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

開発者開発者向け

AI文章調整をプロダクトに組み込む

TurnitPassの開発者向けハブは、APIドキュメント、認証、キー管理、利用制限、執筆ワークフローに必要なAPI機能リファレンスを提供します。

REST API v1

必要なワークフローから始める

開発者ハブ

連携の流れ

キーを作り、エンドポイントを呼び、利用量を確認する。

開発者向けの流れは製品と同じです。アカウント所有のキー、計量されたリクエスト、見える文字数残高、本番ルートに対応するドキュメント。

01

API キーを作成

ワークスペースで名前付きキーを発行し、一度だけコピーします。

02

Bearer リクエストを送る

humanizer、detector、paraphrase、citation、bibliography を呼び出します。

03

利用量を確認

リクエストは文字数残高、エンドポイント記録、請求上限に集計されます。

v1
POST/humanizePOST/paraphrasePOST/detectPOST/citation
リクエスト
POST /humanize
curl -X POST /api/v1/humanize
-H "Authorization: Bearer $KEY"

200 OK

レスポンス

142

使用文字数

2,858

残り

ワークスペース

キーアカウント単位
計量アカウント利用
請求Stripe 対応
上限プラン別

既定で非公開

キーはハッシュ化され、アカウントに紐づきます。

API一覧

主要機能

認証あり

Bearer API キー

計量あり

文字数残高

本番向け

請求フック

文章調整

POST/api/v1/humanize

原文のニュアンスを維持しながら、AIらしい表現を見直しやすくします。

言い換え

POST/api/v1/paraphrase

複数のモードで、文章の言い換えや推敲を行います。

AIチェック

POST/api/v1/detect

AI生成の可能性の目安と見直しポイントを返します。

引用

POST/api/v1/citation

DOI、URL、または手動入力された情報源を引用形式に整えます。

利用シーン

よくある連携

API はブラウザの執筆フローと同じです。humanize、detect、rewrite、paraphrase、cite、利用量の確認。

01POST /api/v1/humanize

コンテンツ基盤

公開前に AI 下書きを自然化し、エディタ内で検出と引用整理を見せます。

02POST /api/v1/paraphrase

執筆ツール

既存の文書フローに paraphrase、rewrite、AIGC 検出を足し、モデル層は自前で持たない。

03POST /api/v1/detect

査読ワークスペース

提出物を detector に送り、メモを残し、査読者に信号を示します。

04POST /api/v1/citation

研究ワークフロー

出典の多い製品や学術アシスタント向けに引用と文献リストを整形します。

本番の詳細

上限、請求、安定性

実際の利用者に TurnitPass を開く前に、クライアントが設計すべき運用ルールです。

認証

Bearer API キー

キーは作成時に一度だけ表示され、Google ログインを変えずに失効できます。

変換上限

1,000 語/リクエスト

humanize、paraphrase、rewrite が上限を共有し、成功時に残高から引きます。

検出上限

5,000 語/リクエスト

検出はより長い入力を受け、見積もり・注記・信号を返します。

レート制限

50 回/分/キー

変換・検出・status はキーあたり毎分 50。引用は 100。

請求

Stripe 対応

checkout、ポータル、webhook、残高、プラン上限は接続済み。本番キーは別途設定。

失敗時

成功時のみ減算

語数はエンジン成功後に減ります。検証失敗では減りません。

運用上の注意

デフォルトでプライベート. API利用はユーザー所有のキーに紐づき、利用量と制限を安全に管理できるよう設計されています。
請求と利用制限. 決済、プラン制限、カスタマーポータルを一つの流れで管理できます。

公開前

公開前チェック

1

テストキーを作成

ワークスペースで API キーを作り、接頭辞が一度だけ出ることを確認します。

2

中核呼び出しを実行

同じ Bearer トークンで humanize、detect、paraphrase、citation、bibliography、status を呼びます。

3

エラーを処理

クライアントで invalid_api_key、rate_limited、insufficient_words、検証エラーを対応づけます。

4

請求を設定

プランと checkout 文面が固まったら Stripe のシークレットと price ID を入れます。

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