アカウントの準備

アカウントを作成し、メールアドレスを確認する

spicyapi.ai/register を開きます。登録方法は 3 つあります。

利用規約とプライバシーポリシーへの同意にチェックを入れ、アカウントを作成を選びます。

表示される画面： メールアカウントの場合は、メールをご確認くださいという見出しのページが表示されます。届いたメールを開き、リンクをクリックしてください。メールアドレスを確認しましたというページが表示されれば確認は完了で、コンソールへからコンソールに入れます。

いま起きたこと： アカウントは作成されましたが、API を呼び出せるのはメールアドレスの確認が済んでからです。それまでは、コンソールにメール未確認のため、API 呼び出しは拒否されますというバナーが表示されます。

• リンクは 1 回だけ使え、24 時間で期限が切れます。期限が切れている場合でもそのリンクを開き、確認リンクを再送するを使うか、コンソールのバナーで確認するを選んでください。
• 数分たってもメールが届かない場合は、迷惑メールフォルダーを確認し、そのうえでもう一度送信を使ってください。

チャージする

コンソールで請求（spicyapi.ai/console/billing）を開き、残高をチャージで次の手順を進めます。

1. 金額を選びます。 用意された金額（たとえば $10、$25、$50、$100）から選ぶか、任意の額を選んで金額を入力します。1 回の支払いでチャージできる最小額と最大額は、コンソールに表示されます。オンライン決済では、小数点以下は 2 桁までです。
2. ボーナスを確認します。 金額によっては、キャンペーンのボーナスが付きます。その場合は、支払う前に +$… ボーナスと表示されます。ボーナスは、支払った金額とは別の項目として追加されます。
3. 支払い方法を選び、下のタブの手順に従います。

ほかに表示されることがあるメッセージ：

• チャージを利用できません、または現在、チャージ注文を作成できません：チャージの受付を一時的に停止しているか、処理待ちの注文が多すぎます。チャージ注文で古い注文を完了するかキャンセルするか、時間をおいてもう一度お試しください。
• 通信が途切れたため、結果が確認できません：二重に支払わないよう、もう一度試す前にチャージ注文を確認してください。

任意：自動チャージを有効にする

自動チャージは、残高が少なくなったときに、保存済みのカードに自動で請求します。これにより、時間のかかる処理が途中で 40201 によって止まるのを防げます。使えるのはカードだけです。

1. 請求で自動チャージを探し、支払い方法を安全に保存を選びます。
2. 開いた安全なページでカード情報を入力します。カード情報は決済事業者が保管します。
3. 請求に戻ると、お支払い方法を確認しています、続いてお支払い方法を保存しましたと表示されます。このカードはご利用いただけませんと表示された場合は、何も保存されていません。別のカードを試してください。
4. 3 つの項目を入力します。
   • 残高がこの額未満でチャージ：請求のきっかけになる残高です。
   • 1 回のチャージ額：1 回の請求で追加する金額です。通常のチャージと同じ範囲内でなければなりません。
   • 月間上限：1 暦月のあいだに自動チャージで請求できる最大額です。1 回のチャージ額より低くはできません。
5. 許可についての同意にチェックを入れ、自動チャージを開始するを選びます。

表示される画面： 自動チャージを開始しました。上限は以下のとおりです。 と表示されます。カードには、ルール（たとえば「残高が $10 を下回ったら $50 を自動チャージ」）と今月の利用額が表示されます。

ルールの詳細：

• 残高はおよそ 30 秒〜2 分ごとに確認されます。利用可能残高がしきい値以下になると、保存済みのカードに設定額を請求します。
• 請求は 1 回ごとに、自動チャージのタグが付いた通常のチャージ注文になります。同じ金額を手動でチャージした場合と同じボーナスが付き、請求書も発行できます。
• 月間上限は UTC の暦月で数えます。使い切ると、自動チャージは翌月 1 日まで待機します。失敗した請求は上限に含まれません。
• 請求に失敗した場合は、1 時間後に再試行し、さらに 6 時間後にもう一度試します。3 回続けて失敗すると、自動チャージは自動的にオフになります。盗難や解約などで銀行がカードをはっきり拒否した場合は、即座にオフになります。請求が 1 回成功すると、失敗の回数はリセットされます。
• 自動的にオフになったあとは、カードの問題を解決する（または新しいカードを保存する）と、もう一度オンにできます。
• 自動チャージを止めるを選べば、いつでも以後の請求を止められます。残高や、すでに完了したチャージが変わることはありません。

API キーを作成する

API キー（spicyapi.ai/console/keys）を開き、キーを作成（または最初のキーを作成）を選びます。

API キーを作成ダイアログで必須なのは名前だけです。詳細設定の中の項目は、すべてあとから変更できます。

名前。 キーを使うもの（production backend や my laptop など）にちなんだ名前を付けます。失効させるときに見分けられるようにするためです。120 文字まで入力できます。

消費上限（詳細設定の中にあり、米ドル建て）。上限に達すると、このキーは期間が切り替わるまで、新しいタスクを 40202 で拒否します。ほかのキーはそのまま使えます。まだ実行中のタスクのために仮押さえされている金額は、すべての上限に計上されます。

どの上限も、0 を入力すると上限なしになります。空欄のままでも同じ意味になります。

利用範囲。

• 利用を許可するモデル。 初期値の すべてのモデル（制限なし） のままにすると、あとから追加されるモデルも含めて、キーはすべてのモデルを呼び出せます。特定のモデルを選ぶと、それ以外のモデルは 40301 で拒否されます。
• IP 許可リスト。 すべて許可にすると、どこからの呼び出しも受け付けます。指定したアドレスのみにすると、入力したアドレスからの呼び出しだけを受け付けます。IPv4、IPv6、または 203.0.113.10, 198.51.100.0/24 のような CIDR 範囲を、カンマ区切りで最大 64 件まで入力できます。オフィスや自宅のネットワーク内部のアドレスではなく、サーバーが呼び出しに使う公開アドレスを指定してください。それ以外の場所からの呼び出しは 40302 で拒否されます。アドレスが変わるノートパソコンでは、すべて許可のままにしてください。
• 有効期限。 7 日、30 日、90 日、1 年、無期限、日付を指定から選びます。キーは UTC でその日が終わった時点で使えなくなり、それ以降は失効したキーと同じ 401 が返ります。

作成を選びます。

表示される画面： キーを作成しましたダイアログに、sk-spicy- で始まるキーの全文が表示されます。キーをコピーでコピーするか、ファイルとして保存を選びます。このキーを安全な場所に保存しましたにチェックを入れ、完了を選びます。

いま起きたこと： キーの全文が表示されるのは、このときだけです。当社が保存しているのはキーの一方向ハッシュだけなので、サポートチームを含め、誰もあとからキーを表示することはできません。なくした場合は、失効させて新しいキーを作成してください。

あとで同じページでできること：

• 編集では、名前、上限、利用を許可するモデル、IP 許可リスト、有効期限を変更できます。変更はすぐに反映されます。
• 失効を選ぶとキーは直ちに使えなくなり、元に戻すことはできません。すでに受理されたタスクは実行を続け、料金も通常どおり課金されます。
• 1 つの範囲で有効なキーは 50 本まで持てます。アプリや環境ごとに 1 本ずつキーを使えば、ほかを止めずに 1 本だけ失効させられます。

キーを SPICY_API_KEY に設定する

環境変数とは、ターミナルが起動するプログラムに渡す、名前付きの値です。公式の SDK、CLI、MCP サーバー、そしてこのドキュメントのすべての例は、SPICY_API_KEY という環境変数からキーを読み取ります。こうしておけば、キーをコマンドに打ち込んだり、プロジェクトの中に保存したりする必要がありません。

まずターミナルを開きます。macOS では Cmd + Space を押して Terminal と入力し、Enter を押します。Windows ではスタートメニューを開いて PowerShell と入力し、Windows PowerShell を開きます。

export SPICY_API_KEY="sk-spicy-paste-your-key-here"

nano ~/.zshrc

echo "${SPICY_API_KEY:0:9}"

サーバーでは、プロジェクト内のファイルではなく、ホスティングサービスのシークレット設定や環境変数の設定で SPICY_API_KEY を設定してください。

無料のテスト呼び出しをする

ここでは残高を問い合わせます。費用はかからず、何も作成されません。それでいて、キーが設定されていること、キーが有効であること、アカウントが API を呼び出せる状態であることの 3 つを一度に確かめられます。

curl https://api.spicyapi.ai/api/v1/chat/credit \
  -H "Authorization: Bearer $SPICY_API_KEY"

期待される結果： 次のような応答が返ります（一部省略）。

{
  "code": 200,
  "msg": "success",
  "data": {
    "available": "25",
    "held": "0",
    "total": "25"
  },
  "request_id": "req_01k..."
}

意味： "code": 200 は成功です。金額は米ドルで、文字列として書かれています。available は新しい生成に使える額、held はまだ実行中の生成のために仮押さえされている額、total はその 2 つの合計です。実際の応答には、支払った資金とキャンペーンの付与残高を区別する funding オブジェクトも含まれていますが、いまは気にしなくてかまいません。

別の結果が返った場合：

curl を使いたくない場合は、CLI の spicyapi balance で同じことができます。