コンテンツへスキップ
最終更新

トラブルシューティング

Tisane APIへのリクエストが失敗した場合、以下のエラーコードとトラブルシューティングの手順を確認してください。

API呼び出しがエラーコード400(Bad Request)で失敗

通常、これは不正な形式または無効なリクエストボディを意味します。/parse/transformでは、入力コンテンツと有効な言語コードを指定する必要があります。

考えられる原因:

  • 無効なJSON。文字列に未終了の文字列リテラルやエスケープされていないダブルクォートが含まれていないか確認してください。
  • 無効な言語コード。言語モデルが存在し、属性名が正しいことを確認してください(/parse ではlanguage/transformではfromto)。
  • content要素の欠落

API呼び出しがエラーコード401(Unauthorized)で失敗

これは、リクエストが認証に失敗したことを意味します。考えられる原因:

  • 不正なAPIキー

    • Ocp-Apim-Subscription-Key HTTPヘッダーに正しいAPIキー値を必ず指定してください。
  • レート制限超過

    • 各サブスクリプションプランにはレート制限があります。無料のCommunity Planのレート制限は、1分あたり10リクエストのみに設定されています(テストには十分ですが、ほとんどの用途の本番環境には不十分です)。サブスクリプションプランページでレート制限を確認してください。
  • 月間クォータ超過

API呼び出しがエラーコード404で失敗

メソッド名が正しいことを確認し、動詞が正しいことを確認してください。例えば、操作にPOSTを使用している場合にGETを指定すると、ステータスコード404が返されます。

その他のエラーコード(Invalid JSONまたはMarkup Issues)

401以外のエラーが表示される場合は、JSONのフォーマットが不正であるか確認してください。

  • ダブルクォートの適切なエスケープ

    • コンテンツにダブルクォート (") が含まれている場合、適切にエスケープ(\") しているか確認してください。
  • マークアップコンテンツの送信の回避

    • Tisane APIは自然言語を処理するため、コンテンツとしてHTML、XML、またはJSONを送信すると問題が発生する可能性があります。
    • マークアップを送信する必要がある場合は、送信前に入力内容のサニタイズを行ってください。

APIキーの取得

tl;dr:開発者向けポータルにサインインし、プロフィールページからAPIキーを取得してください。

手順

  1. こちらをクリックして、ご登録の認証情報でログインします。
  2. アカウントをお持ちでない場合は、こちらから登録します。
  3. 画面の右上にあるメニューをクリックして、「プロフィール」に移動するか、**こちらのダイレクトリンクを使用します。
  4. 「プライマリキー」または「セカンダリキー」で、「表示」をクリックしてAPIキーを表示します。******
  5. アプリケーション内で、このキーをOcp-Apim-Subscription-Key HTTPヘッダーとして指定します。

一般的なトラブルシューティングの手順

  • APIキーを確認します。
  • サブスクリプションの制限を確認します
  • 送信前にJSONフォーマットを検証します
  • 入力内容のサニタイズを行い、任意のマークアップを削除します

期待する応答が得られていません

100%の精度を保証することはできませんが、ご不明な点がございましたら、お問い合わせください。ご確認いたします。当社は、Tisaneの精度向上に継続的に取り組んでおり、お客様のご協力に感謝いたします。

マークアップコンテンツ(HTMLまたはXML)からテキストを処理することはできますか?

以下の正規表現は、任意のプログラミング言語でテキストからHTMLタグを削除するために使用できる汎用的なものです。

<[^>]+>

  • < → HTMLタグの開始角括弧と同等です。
  • [^>]+タグ内の任意の文字(>を除く)と同等です。
  • > → HTMLタグの閉じ角括弧と同等です。