にんしょう

すべての API リクエストには API Key によるにんしょうがひつようです。诺玛AI はひとつのとういつ API Key をつかい、3 つのプロトコルのにんしょうにたいおうします。

API Key をえる#

  • 诺玛AI コンソールにとうろくしてログインする
  • Settings -> API Keys へすすむ
  • Create new key をクリックする
  • API Key をコピーし、あんぜんにほかんする

API Key はさくせいじに 1 かいだけひょうじされます。なくしたら、あたらしくつくりなおしてください。

にんしょうほうほう#

にんしょうほうほうはプロトコルごとにすこしちがいます:

OpenAI ごかん

OpenAI ごかんプロトコルは `Authorization` Header をつかいます:

コード
Authorization: Bearer <あなたの APINOMA_API_KEY>

Anthropic ネイティブ

Anthropic ネイティブプロトコルは `x-api-key` Header をつかいます:

Gemini ネイティブ

Gemini ネイティブプロトコルは `x-goog-api-key` Header または URL パラメータをつかいます:

かんきょうへんすう#

API Key はかんきょうへんすうでかんりし、ハードコーディングをさけることをおすすめします:

コード
APINOMA_API_KEY=<あなたの APINOMA_API_KEY>

# プロトコル専用の環境変数を設定することもできます
OPENAI_API_KEY=<あなたの APINOMA_API_KEY>
OPENAI_BASE_URL=https://as.apinoma.com/v1

ANTHROPIC_API_KEY=<あなたの APINOMA_API_KEY>
ANTHROPIC_BASE_URL=https://as.apinoma.com/anthropic

GEMINI_API_KEY=<あなたの APINOMA_API_KEY>
GEMINI_BASE_URL=https://as.apinoma.com/gemini

セキュリティのベストプラクティス#

  • かんきょうへんすうをつかう — コードに API Key をハードコーディングしない
  • キーをていきてきにローテーションする — 90 にちごとがおすすめです
  • かんきょうをわける — かいはつとほんばんでべつの API Key をつかう
  • りようりょうをみる — コンソールで API りようりょうとふしんなコールをていきてきにかくにんする
  • けんげんをしぼる — プロジェクトごとにべつの API Key をつくり、トラッキングとマネジメントをしやすくする

API Key を Git リポジトリにコミットしたり、クライアントがわコードでさらしたりしないでください。`.gitignore` で `.env` ファイルをのぞいてください。

さいしゅうこうしん: 2026 ねん 6 がつ 23 にち