APIキー

APIキーは、Novita AI へのリクエストを認証します。このページでは、キーの仕組み、キーの作成と保存の方法、そして各環境でキーを継続して利用できるようにする方法について説明します。このページでは、次のことを行います。

Bearer APIキーで Novita AI へのリクエストを認証する。
コンソールから APIキーを作成し、安全に保存する。
Linux、macOS、Windows でキーを環境変数として設定する。
キーの有効期間と、OpenAPI が対象とする内容および対象としない内容を理解する。

認証

Novita AI は Bearer 認証を使用して API アクセスを認証します。APIキーを次の場所に送信します。 Authorization リクエストヘッダー:

Authorization: Bearer <API Key>

リクエストの例:

curl "https://api.novita.ai/openai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -d '{
    "model": "deepseek/deepseek-r1",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

APIキーを作成する

Key Managementを開く

コンソールの Key Management に移動します.

新しいキーを作成する

Create API Key を選択し、キーにその目的を反映した名前を付けます。たとえば production または local-testing.

キーをコピーして保存する

完全なキーは作成時に一度だけ表示されます。すぐにコピーし、シークレットマネージャーや環境変数などの安全な場所に保存してください。紛失した場合、復元することはできません — 代わりに新しいキーを作成してください。

必要に応じて、キーが呼び出しを許可されるモデルを制限できます。API キーのモデルアクセス.

キーの形式と有効性

すべてのキーは次で始まります sk_ プレフィックス。
キーは作成時に一度だけ完全な形で表示されます。その後、コンソールにはマスクされた形式で表示されます。
キーは作成されると無期限に有効です。コンソールで削除するまで動作し続けます。
各アカウントは最大 10 個の API キーを作成できます。

OpenAPI の対象範囲

API キーの作成と削除はコンソールでのみ行います。Novita OpenAPI には、キーを作成または削除するためのエンドポイントは含まれていません。キー関連の OpenAPI エンドポイントは、キーの一覧表示とキーのモデルアクセスポリシーの管理を対象としています:

API キーを一覧表示 — チームのキーを一覧表示し、任意でモデルアクセスの概要を含めます。
API キーのモデルアクセスポリシーを取得 — 単一キーのモデルアクセスポリシーを読み取ります。
APIキーのモデルアクセスポリシーを設定 — キーのモデルアクセスポリシーを設定または更新します。
API キーのモデルアクセスポリシーをリセット — キーのモデルアクセスポリシーをデフォルトにリセットします。これによりリセットされるのはポリシーのみで、キー自体は削除されません。

キーを環境変数として保存する

ソースコードにキーをハードコードすると、たとえばそのファイルをコミットしたときに漏えいするリスクがあります。キーは、たとえば NOVITA_API_KEY コードに含めずに済みます。

一時的 vs. 永続的

A key set with export (Linux/macOS) または set (Windows) は現在のターミナルセッションの間だけ有効で、閉じると消えます。簡単なテストにはそれで問題ありません。セッションをまたいでキーを保持するには、以下のように永続的に設定し、その後、新しいターミナルを開いて変更を反映させます。

# Temporary: current session only
export NOVITA_API_KEY="<Your API Key>"

# Permanent: append to your shell profile, then reload
echo 'export NOVITA_API_KEY="<Your API Key>"' >> ~/.bashrc
source ~/.bashrc

# Temporary: current session only
export NOVITA_API_KEY="<Your API Key>"

# Permanent: append to your shell profile, then reload
# Newer macOS uses zsh (~/.zshrc); older setups use bash (~/.bash_profile)
echo 'export NOVITA_API_KEY="<Your API Key>"' >> ~/.zshrc
source ~/.zshrc

# Temporary: current PowerShell session only
$env:NOVITA_API_KEY = "<Your API Key>"

# Permanent: persist for the current user, then open a new terminal
setx NOVITA_API_KEY "<Your API Key>"

コード内で環境からキーを読み戻します:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.novita.ai/openai",
    api_key=os.environ.get("NOVITA_API_KEY"),
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.novita.ai/openai",
  apiKey: process.env.NOVITA_API_KEY,
});

変数は設定されているのに、コードがまだ見つけられない

一時的に設定して、新しいターミナルを開いた

で設定されたキーは export または $env: 実行したターミナルセッション内でのみ有効です。新しいターミナル、または新しいタブには引き継がれません。キーを永続的に設定します (>> ~/.zshrc, setx), または再実行します export/$env: 使用しているセッション内の行。

永続的に設定したが再起動していない

永続的な変更 (シェルプロファイル, setx) は変更後に起動したターミナルに適用されます。新しいターミナルを開き、IDE またはエディターを再起動して、新しい環境を認識させてください。Windows では、 setx すでに開いているターミナルには影響しません。

サービスマネージャーはシェル環境を継承しません

によって起動されたプロセス systemd, supervisor, Docker, または CI runner は、対話型シェルのプロファイルを読み込みません。その変数はサービス独自の設定で設定してください (たとえば、 systemd ユニットの Environment=, 1つの docker run -e フラグ、または CI プロジェクトのシークレット) 内ではなく、 ~/.bashrc.

sudo でコマンドを実行しました

sudo デフォルトでは環境を引き継がないため、ユーザーとしてエクスポートした変数は昇格されたプロセスからは見えません。次を使用してください sudo -E 環境を保持するため、または昇格されたコンテキスト内で変数を設定します。

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

認証

APIキーを作成する

キーの形式と有効性

OpenAPI の対象範囲

キーを環境変数として保存する

一時的 vs. 永続的

変数は設定されているのに、コードがまだ見つけられない

関連

​認証

​APIキーを作成する

​キーの形式と有効性

​OpenAPI の対象範囲

​キーを環境変数として保存する

​一時的 vs. 永続的

​変数は設定されているのに、コードがまだ見つけられない

​関連

認証

APIキーを作成する

キーの形式と有効性

OpenAPI の対象範囲

キーを環境変数として保存する

一時的 vs. 永続的

変数は設定されているのに、コードがまだ見つけられない

関連