AI Humanizer API
1回のREST呼び出しで、自社製品内のAI文を人間化します。AI humanizer APIは、TextPulseを支えるエンジンをバックエンドに公開します。JSONを送信すると、書き換えられた散文が返り、60以上の言語に対応します。
最初のリクエストの作成
Authorization: Bearer ヘッダーで認証し、テキストを送信します。書き換え後の版は、outputText として、その呼び出しの計測値とともに返されます。
curl https://textpulse.ai/api/v1/humanize \ -H "Authorization: Bearer tp_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Our analysis indicates the intervention produced gains...", "writingMode": "Academic", "intensityScalar": 0.5 }'{ "outputText": "Our analysis points to measurable gains from the...", "metrics": { "inputWords": 128, "outputWords": 134, "wordsCharged": 128, "balanceRemaining": 99872, "modelLatencyMs": 4310, "route": "v1/humanize" }}AI humanizer API とは何ですか。
AI humanizer API は、別の製品の内部から機械生成テキストを自然で人間らしく読める文章へ書き換える REST エンドポイントです。テキストを Web アプリに貼り付ける代わりに、バックエンドが JSON として送信し、書き換え後の版をレスポンスで受け取ります。そのため、humanization は自社ソフトウェアの機能になります。たとえば、エディタ内のボタン、文書パイプラインの1段階、コンテンツライブラリ全体に対するバッチジョブです。
TextPulse humanizer API は、TextPulse ダッシュボードを動かしているものと同じエンジンを公開しています。20を超える言語的シグナルを同時に扱い、文の長さと構造を変化させ、言語モデルが過剰に選びがちな語彙を置き換えます。一方で、本文中の引用、参考文献項目、統計値、固定化された用語はそのまま通過します。2,000件の学術コーパスでは、humanized 出力は Turnitin AI を92.33%の確率で、Originality.ai を89.12%、GPTZero を87.91%の確率で通過しました。この学術水準の挙動が、一般的な言い換えエンドポイントと異なる点です。ユーザーが受け取るテキストは、単に別物であるだけでなく、公開可能な品質です。
AI humanizer APIが代行する内容
言語ルーティング、文体制御、計測、再試行の安全性はエンドポイントに含まれるため、統合は単一関数のまま保てます。
1つのルートで60以上の言語をカバー
英語は調整済みの humanizer エンジンで処理されます。language 値を渡すと、リクエストは代わりに多言語パスへルーティングされるため、英語以外の製品ページでも別の統合なしに同じエンドポイントを利用できます。
文体と強度はパラメータ
5つの文体モードで、Academic, Corporate, Creative, Blog/SEO, General の各文体をカバーします。intensityScalar 値は書き換えが元文とどれだけ異なるかを設定し、0, 0.25, 0.5, 0.75, 1 のいずれかを取ります。Mild から、0.5 の Balanced デフォルトを経て Aggressive まで連続します。
文書ごとに1回のPOST
照会するジョブキューも、登録する webhook もありません。humanize 呼び出しはモデルが返すまで接続を保持し、書き換え後のテキストで応答するため、1回のリクエストで処理が完了します。
再試行で二重課金されない
requestId を送信すると、その結果は約10分間その ID に対してキャッシュされます。同じ識別子でその時間内に再送すると、モデルを再実行せず保存済みの応答が返されます。エンジンが完了できなかったリクエストの語数は、自動的に残高へ戻されます。
エンドポイント参照
Authorization: Bearer ヘッダーからキーを読み取ります。キーは tp_live_ で始まり、プロジェクトごとに発行されます。/api/v1/humanize/api/v1/balance1回の humanize 呼び出しで受け付けられるのは、10,000文字上限内で最大1,000語です。各キーは1分あたり60リクエストを発行できます。長文は一連の呼び出しとして送信します。
リクエストパラメータ
必要なのは text のみです。ほかはすべて妥当な既定値があるため、最小限の統合は1項目で済みます。
| パラメータ | Type | 有無 | 注記 |
|---|---|---|---|
text | string | 必須 | humanize するテキストです。1回のリクエストにつき10,000文字上限の範囲で、最大1,000語まで対応します。 |
writingMode | string | 既定値: Academic | Academic, Corporate, Creative, Blog/SEO, General のいずれかです。書き換えが保つ文体を設定します。 |
intensityScalar | number | 既定値: 0.5 | 0, 0.25, 0.5, 0.75, 1 のいずれかです。書き換えが元文からどの程度離れるかを示し、Mild から Balanced、Aggressive へと変化します。 |
language | string | 任意 | 英語以外のテキストを多言語経路へ振り分けます。英語の細調整済みエンジンを使う場合は、省略するか英語を送信してください。 |
englishVariant | string | 任意 | American または British です。綴りと語彙を大西洋の片側に統一します。 |
freezeTerms | string[] | 任意 | 書き換えをそのまま通過させる10語または10句までを指定します。構成名、機器名、製品名などです。 |
removeEmDashes | boolean | 任意 | em dash を用いた構文を通常の句読点に書き換えます。 |
requestId | string | 推奨 | 冪等性トークンです。おおむね10分以内に同じものを再送すると、再課金せずに保存済みレスポンスを再生します。 |
レスポンスフィールド
outputTexthumanized されたテキストです。metrics.inputWords / outputWords受信した語数と返却した語数です。書き換え後は元文よりわずかに長くなることがよくあります。metrics.wordsChargedこの呼び出しの費用です。常に入力語数と等しく、出力語数とは一致しません。metrics.balanceRemainingこの呼び出し後にキーに残っている単語クレジットです。追加リクエストなしで計測できます。metrics.modelLatencyMs / route書き換えに要したエンジン時間と、それを処理した経路です。エラーと再試行
すべてのエラーは、安定した error.code と人間が読めるメッセージを含む JSON を返します。設計上重要な規則は、課金されるのは配信された書き換えだけであり、同じ requestId で再試行しても常に安全だということです。
UNAUTHORIZEDAPI key がないか、認識されません。Authorization: Bearer ヘッダーを確認してください。INSUFFICIENT_BALANCEキーの単語クレジットが不足しています。レスポンスには利用可能残高が含まれます。REQUEST_IN_PROGRESSこの requestId を持つリクエストはまだ処理中です。競合させず、完了を待ってください。TOO_LONG / VALIDATION_FAILED入力が1,000語上限を超えているか、パラメータに不備があります。レスポンスに具体的な問題が列挙されます。ENGINE_ERRORエンジンが失敗したか、タイムアウトしました。単語はすでに残高へ戻されています。同じ requestId で再試行してください。エンドポイントの背後にあるエンジン
すべての呼び出しは公開済みのTextPulseエンジンで実行され、2,000件の文書からなる学術コーパスで測定され、検出モデルの更新に合わせて再実行されます。検出器別の通過率:
ベンダーが自社コーパスとともに公開した測定値です。いかなるhumanizerも、特定の文書に対する検出器の結果を約束することはできません。そのため、製品の訴求は保証ではなく測定値に基づけてください。
チームがhumanizer APIの上に構築するもの
EdTechおよびライティングプラットフォーム
既存の文法機能や言い換え機能の横にhumanizeアクションを追加します。Academicモードは引用をそのまま保持するため、学生向けツールはテキストを送信する前に参考文献を削除する必要がありません。
文書および校正ツール
文書全体を1,000語単位のチャンクで処理し、再結合します。Freeze termsはチャンク間で名称と用語を安定して保持し、冪等な再試行によりバッチパイプラインを安全に再実行できます。
コンテンツおよびSEO製品
Blog/SEOモードは下書きを公開可能な文章へ書き換え、freeze termsは対象キーワードを固定するため、コピーは検索意図を保ちつつ機械的なリズムを失います。
ホワイトラベルパートナー
このエンドポイントは製品内で目に見えない形で動作します。あなたのインターフェース、あなたの請求、私たちのエンジンです。パートナー契約は、アクセスフォームを通じて月間利用量に基づいて見積もられます。
AI humanizer APIの料金
クレジットは前払いで、語数に応じて消費されます。課金はエンジンが返す語数ではなく送信した語数で計算され、書き換えを生成できなかった呼び出しはキーに返金されます。
クレジットは購入から12か月間有効で、エンドポイントが対応するすべての言語、執筆モード、英語の変種を対象とします。継続的な大量利用、または自社製品内でのホワイトラベル契約をご希望の場合は、アクセスをリクエストしてください。月間規模に基づいて見積もりを提示します。
AI humanizer APIに関する質問
APIキーを取得する
キーはプロジェクトごとに発行されます。取り組んでいる内容を説明してください。24時間以内に返信します。