Tisane APIへのリクエストが失敗した場合、以下のエラーコードとトラブルシューティングの手順を確認してください。
通常、これは不正な形式または無効なリクエストボディを意味します。/parseと/transformでは、入力コンテンツと有効な言語コードを指定する必要があります。
考えられる原因:
- 無効なJSON。文字列に未終了の文字列リテラルやエスケープされていないダブルクォートが含まれていないか確認してください。
- 無効な言語コード。言語モデルが存在し、属性名が正しいことを確認してください(
/parseではlanguage、/transformではfromとto)。 content要素の欠落
これは、リクエストが認証に失敗したことを意味します。考えられる原因:
不正なAPIキー
Ocp-Apim-Subscription-KeyHTTPヘッダーに正しいAPIキー値を必ず指定してください。
レート制限超過
- 各サブスクリプションプランにはレート制限があります。無料のCommunity Planのレート制限は、1分あたり10リクエストのみに設定されています(テストには十分ですが、ほとんどの用途の本番環境には不十分です)。サブスクリプションプランページでレート制限を確認してください。
月間クォータ超過
- 月間クォータに達した場合は、サブスクリプションプランページでアップグレードをご検討ください。月間クォータに近づくと、複数の通知が送信されます。
メソッド名が正しいことを確認し、動詞が正しいことを確認してください。例えば、操作にPOSTを使用している場合にGETを指定すると、ステータスコード404が返されます。
401以外のエラーが表示される場合は、JSONのフォーマットが不正であるか確認してください。
ダブルクォートの適切なエスケープ
- コンテンツにダブルクォート (
") が含まれている場合、適切にエスケープ(\") しているか確認してください。
- コンテンツにダブルクォート (
マークアップコンテンツの送信の回避
- Tisane APIは自然言語を処理するため、コンテンツとしてHTML、XML、またはJSONを送信すると問題が発生する可能性があります。
- マークアップを送信する必要がある場合は、送信前に入力内容のサニタイズを行ってください。
tl;dr:開発者向けポータルにサインインし、プロフィールページからAPIキーを取得してください。
- こちらをクリックして、ご登録の認証情報でログインします。
- アカウントをお持ちでない場合は、こちらから登録します。
- 画面の右上にあるメニューをクリックして、「プロフィール」に移動するか、**こちらのダイレクトリンクを使用します。
- 「プライマリキー」または「セカンダリキー」で、「表示」をクリックしてAPIキーを表示します。******
- アプリケーション内で、このキーを
Ocp-Apim-Subscription-KeyHTTPヘッダーとして指定します。
- APIキーを確認します。
- サブスクリプションの制限を確認します
- 送信前にJSONフォーマットを検証します
- 入力内容のサニタイズを行い、任意のマークアップを削除します
100%の精度を保証することはできませんが、ご不明な点がございましたら、お問い合わせください。ご確認いたします。当社は、Tisaneの精度向上に継続的に取り組んでおり、お客様のご協力に感謝いたします。
以下の正規表現は、任意のプログラミング言語でテキストからHTMLタグを削除するために使用できる汎用的なものです。
<[^>]+>
<→ HTMLタグの開始角括弧と同等です。[^>]+→ タグ内の任意の文字(>を除く)と同等です。>→ HTMLタグの閉じ角括弧と同等です。