使用量・信頼性・データ処理

レコード、ティア、エラー、再試行、認証情報、保持、オフライン有効化を理解します。

レコード、処理区分、請求周期

基本レコードの上限は 1.000 Unicodeコードポイント ／テキストです。各テキストを個別に切り上げ、最低1単位とします。API処理区分の係数を適用し、小数は0.1レコード単位で保持します。

例えば、800文字のテキスト2件はStandardで2、Batchで1、Real-Timeで3,2レコードを消費します。ネイティブBatchは優先度の低い処理区分です。Azureの非同期ジョブは別のリクエストライフサイクルです。

プラン枠を先に消費し、その後パックを使用します。月間枠は請求期間の境界でリセットされ、繰り越されません。パックに有効期限はありません。アップグレードは支払い後に新周期と新しい全枠で開始し、ダウングレード・解約は現在の期間末に適用されます。確定前にダッシュボードで請求額をご確認ください。

使用量は次で確認できます：ダッシュボードまたは GET /v1/usage。請求ポータルには請求書PDF、会社情報、支払い方法があります。適用される税金は購入時に計算され、購入後に請求書をメールで送信します。

ネイティブAPIエラーの形式は {"error":{"code":"…","message":"…"}}です。Azure互換エンドポイントは独自のエラー形式を使用します。問題調査のために X-Request-Id を保存してください。

状態	操作
401	キー、失効状態、環境を確認してください。
402	レコードを追加してください。エラーには必要量と利用可能量が表示されます。
403	プランが指定した処理区分に対応するか確認してください。
413 / 422	入力を修正するか、記載された上限内でリクエストを分割してください。
429	次の値に従ってください： `Retry-After`。その後、待機時間を増やしランダムな揺らぎを加えて再試行します。
503	一時的なサービス障害です。次の値に従ってください： `Retry-After` （存在する場合）。

検証エラーや処理前に拒否されたリクエストはレコードを消費しません。接続切断だけでは処理失敗とは判断できません。リクエスト参照を保持し、大量処理を再試行する前に使用量を確認してください。同期結果は再取得用に保存されません。

同期テキストと置換対応表はメモリ上で処理します。運用上の使用記録には文書内容ではなくID、数量、時間を保存します。非同期ジョブの入力と結果は暗号化した一時ストレージに保存し、24時間後に失効します。返された結果と対応表の保持期間はお客様のアプリケーションで管理します。

APIキーはダッシュボードで作成・失効できます。Starterは1個、上位プランは最大5個です。本番キーの接頭辞は shr_live_、サンドボックスキーは shr_test_です。それぞれ別の環境に属します。ブラウザアプリ、URL、サポートへのメッセージに含めないでください。