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

開発者クイックスタート

最初の文章調整リクエストを送信する

ワークスペースからAPIキーを作成し、同じキーを使用して文章調整、AIチェック、引用機能を呼び出します。

REST API v1

5分の経路

空のワークスペースから最初の改稿まで。

公開プロダクトと同じ順です。アクセス作成、残量確認、キー発行、サーバーから執筆エンドポイントを呼び出します。

連携経路

先に必要なこと

ワークスペースを作る

01

Google ログインで専用 API ワークスペースが開きます。

語数を追加する

02

checkout と portal の接続は済みです。本番 Stripe キーを待つ状態です。

キーを発行する

03

一度だけコピーし、サーバーに保存します。

/humanize を呼ぶ

04

テキストを送り、計量された結果を受け取ります。

サーバーリクエスト

改稿エンドポイント

v1 利用可
request
POST
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 the AI-assisted draft you want to revise",
    "language": "en",
    "mode": "reduce-aigc"
  }'
response
200 OK
{
  "output": "The revised text...",
  "words_used": 142,
  "words_remaining": 2858
}

次の呼び出し

レビュー循環が必要なら、検出または引用エンドポイントと組み合わせます。

例を見る

5分以内

準備

1

アカウントを作る

Google でログインし、請求、API キー、使用量、語数残高を管理します。

2

プランまたは語数枠を選ぶ

Stripe checkout とカスタマーポータルは接続済みです。本番キーと価格は最終設定です。

3

API キーを作る

ワークスペースで発行し、すぐにコピーして Bearer トークンとして送ります。

4

最初のリクエストを送る

下の例で改稿エンドポイントを呼び、応答形を確認します。

最初の API 呼び出し

tp_live_your_api_key をワークスペースのキーに置き換えます。ブラウザではなくサーバーから送ってください。

改稿リクエスト
curl
curl -X POST https://turnitpass.com/api/v1/humanize \
  -H "Authorization: Bearer tp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text":"調整したいAI補助の下書きを貼り付けます","language":"en","mode":"reduce-aigc","personal_terms":["固有名詞"]}'
言い換えリクエスト
curl
curl -X POST https://turnitpass.com/api/v1/paraphrase \
  -H "Authorization: Bearer tp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text":"この段落をより自然な学術的な表現に書き換えてください。","mode":"academic"}'

応答

response
200 OK
{
  "output": "The humanized version of your text...",
  "words_used": 8,
  "words_remaining": 249992
}
失敗した改稿は構造化 JSON エラーを返します。検証やエンジン失敗では語数を消費しません。

最初の呼び出しのあと

ワークフロー例

多くの連携は複数面を組み合わせます。改稿の前後で検出を使い、出典が必要なら citation と bibliography を使います。

検出リクエスト
POST /api/v1/detect
curl -X POST https://turnitpass.com/api/v1/detect \
  -H "Authorization: Bearer tp_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Paste at least 50 words of writing to scan.",
    "language": "en",
    "source_kind": "paste"
  }'
引用リクエスト
POST /api/v1/citation
curl -X POST https://turnitpass.com/api/v1/citation \
  -H "Authorization: Bearer tp_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "https://example.com/research-article",
    "style": "apa"
  }'
引用と参考文献の応答には整形テキストと、BibTeX や RIS などの書き出しが含まれます。

次のステップ

01

APIキーによる認証

開発者向けリクエストには、TurnitPassのワークスペースで生成されたAPIキーを使用します。

02

TurnitPass REST API

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

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