認証
すべての Shisa サービスは、共通ホスト https://api.shisa.ai 上で HTTPS 経由でアクセスし、API キーで認証します。本ガイドでは、キーの取得方法、安全な管理方法、そして各サービスが要求する正確な Authorization ヘッダーについて説明します。
API キーを取得する
キーの作成と管理は Shisa プラットフォーム で行います。新規アカウントには $10 分の無料 API クレジットが付属しており、これは LLM、ASR、TTS、翻訳のすべてのサービスで利用できます。そのため、支払い方法を追加する前にすべてを試すことができます。
キーを秘密に保つ
API キーは、アカウントのクレジットとクォータへのアクセスを許可します。パスワードと同じように扱ってください。
- キーをソース管理にコミットしないでください。 代わりに、たとえば
SHISA_API_KEYのような環境変数から読み込みます。 - キーをクライアントサイドのコードに埋め込まないでください — ブラウザの JavaScript、モバイルアプリ、ユーザーが調べられるものすべてが対象です。自分のバックエンドから Shisa を呼び出し、リクエストをプロキシしてください。
- 漏洩した疑いがある場合はすぐにキーをローテーションし、使用していないキーは削除してください。
# Set the key once in your shell or deployment environment
export SHISA_API_KEY="YOUR_API_KEY"
フロントエンドのコードや公開リポジトリに API キーを露出させないでください。漏洩したキーは、取り消すまでクレジットを消費するために使われる可能性があります。キーはサーバーサイドに保持し、環境から読み込んでください。
認証ヘッダー
すべての Shisa サービスは、同じ Authorization ヘッダーを使用します:
Authorization: Bearer YOUR_API_KEY
Shisa の API キーは shsk: で始まります（例: shsk:abc123…）。shsk: プレフィックスを含むキー全体を、そのままベアラートークンとして渡してください。
| Service | Endpoint | Authorization header |
|---|---|---|
| LLM | POST /openai/v1/chat/completions | Authorization: Bearer YOUR_API_KEY |
| TTS | POST /tts, GET /tts/voices | Authorization: Bearer YOUR_API_KEY |
| ASR | POST /asr/srt/audio_llm | Authorization: Bearer YOUR_API_KEY |
| Translation | POST /translate/ | Authorization: Bearer YOUR_API_KEY |
例
Shisa LLM は OpenAI 互換で、他のすべてのサービスも同一のヘッダーを使用します。完全な例については LLM クイックスタートを参照してください。
curl -XPOST https://api.shisa.ai/openai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $SHISA_API_KEY" \
-d '{"model": "shisa-ai/shisa-v2.1-llama3.3-70b", "messages": [{"role": "user", "content": "こんにちは"}]}'
リクエストが HTTP 401 と Authentication error: Invalid token のようなエラーで失敗する場合、最も一般的な原因はキーの欠落または不正な形式です。shsk: プレフィックスを含むキー全体を Authorization: Bearer YOUR_API_KEY として渡していることを確認してください。エラーの完全な形については エラーを参照してください。