ドキュメント

動く呼び出しから始める

レシピは 3 つ。それぞれに実際の入力、呼び出し、応答例、最初に当たるエラーがあります。

ユースケース

文が有害かを見る

ユーザーの文があり、表示する前に可否の信号が必要です。

入力

{
  "text": "This product is absolutely amazing"
}

呼び出し

有害性チェック · 呼び出し

curl -X POST https://api.brainiall.com/v1/nlp/toxicity \
  -H "Authorization: Bearer $BRAINIALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"This product is absolutely amazing"}'

応答例

{
  "label": "not_toxic",
  "score": 0.001
}

空のテキストは拒否されます。空でない text を送って再試行してください。

文を読み上げる

言葉があり、再生または保存できる音声が必要です。

入力

{
  "text": "Hello, welcome.",
  "voice": "brainiall-aria"
}

呼び出し

合成音声 · 呼び出し

curl -X POST https://api.brainiall.com/v1/tts/synthesize \
  -H "Authorization: Bearer $BRAINIALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, welcome.","voice":"brainiall-aria"}' \
  --output speech.wav

応答例

{
  "content_type": "audio/wav",
  "note": "Binary audio. Save the body to speech.wav."
}

空のテキストは拒否されます。空でない text を送ってください。voice は GET /v1/tts/voices のカタログ ID である必要があります。

話した文を採点する

学習者が文を話しました。参照テキストに対する点数が必要です。

入力

{
  "audio": "<base64-wav>",
  "text": "Hello world"
}

呼び出し

発音 · 呼び出し

curl -X POST https://api.brainiall.com/v1/pronunciation/assess/base64 \
  -H "Authorization: Bearer $BRAINIALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio":"<base64-wav>","text":"Hello world"}'

応答例

{
  "overallScore": 86,
  "sentenceScore": 84,
  "decodedTranscript": "Hello world",
  "words": [
    { "word": "Hello", "score": 90 },
    { "word": "world", "score": 82 }
  ]
}

音声がないと拒否されます。audio に base64 音声と参照テキストを送ってください。

認証

どの呼び出しも同じヘッダーを使います。プレースホルダーをキーに置き換えてください。

ライセンス: Bear Your_Key

ベースURLhttps://api.brainiall.com

NLP Suite エンドポイント

Detect toxic, offensive, or harmful content in text.

コード例

curl -X POST https://api.brainiall.com/v1/nlp/toxicity \
 -H "Authorization: Bearer $BRAINIALL_API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"text":"This product is absolutely amazing"}'

次へ: この呼び出しを今すぐ実行

有害性チェック

今すぐ最初の呼び出しを実行

文が有害かを調べます。ラベルとスコアが返ります。

テキストの呼び出し1回。エンジンは文が有害かを返します。

エンドポイント

POST /v1/nlp/toxicity

リクエスト

{
  "text": "This product is absolutely amazing"
}

APIキーを準備しています…

コード例

curl -X POST https://api.brainiall.com/v1/nlp/toxicity \
  -H "Authorization: Bearer $BRAINIALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"This product is absolutely amazing"}'

すぐ実行できるコレクション

{
  "name": "Brainiall first call",
  "baseUrl": "https://api.brainiall.com",
  "authorization": "Bearer $BRAINIALL_API_KEY",
  "requests": [
    {
      "id": "pronunciation",
      "method": "POST",
      "path": "/v1/pronunciation/assess/base64",
      "url": "https://api.brainiall.com/v1/pronunciation/assess/base64",
      "body": {
        "audio": "UklGRmQBAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YUABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==",
        "text": "Hello world"
      }
    },
    {
      "id": "tts",
      "method": "POST",
      "path": "/v1/tts/synthesize",
      "url": "https://api.brainiall.com/v1/tts/synthesize",
      "body": {
        "text": "Hello, welcome.",
        "voice": "brainiall-aria"
      }
    },
    {
      "id": "nlp",
      "method": "POST",
      "path": "/v1/nlp/toxicity",
      "url": "https://api.brainiall.com/v1/nlp/toxicity",
      "body": {
        "text": "This product is absolutely amazing"
      }
    }
  ]
}

同じリクエストを、このブラウザの外に貼り付けて実行できます。プレースホルダをキーに置き換えてください。キーはこの画面に出ません。