本文へスキップ

OpenAI 互換

OpenAI のコードはそのまま、ベース URL だけ変更

SpicyAPI は OpenAI の chat completions 形式に対応しています。互換性のある SDK、フレームワーク、チャットアプリの接続先を当社のベース URL に向け、カタログのモデル ID を指定すれば、いつもどおりストリーミングで返信を受け取れます。

OpenAI 互換 API とは?

OpenAI のチャット API と同じ形式のリクエストを受け付けます。OpenAI 向けに作られたツールなら、3 つの設定を変えるだけで SpicyAPI と通信できます。

  1. あなたのアプリやチャットクライアントOpenAI SDK、LangChain、SillyTavern など
  2. SpicyAPIapi.spicyapi.ai/v1
  3. チャットモデル1 つのキーで 26 モデル
コードは OpenAI 形式のリクエストを送ったまま。変わるのは、接続先、キー、モデル名だけです。

こんなときに

  • OpenAI SDK を使っているアプリ接続先とキーを替えるだけ。ほかのコードはそのままです。
  • ロールプレイ・チャットアプリSillyTavern、RisuAI、Agnai は、カスタム OpenAI エンドポイントとして接続できます。
  • エージェントフレームワークLangChain、Vercel AI SDK、Aider は、OpenAI 用のアダプター経由で使えます。

3 ステップで接続

  1. ステップ 1

    API キーを作成

    ログインして、コンソールでキーを作成します。キーは sk-spicy- で始まります。

    header
    Authorization: Bearer sk-spicy-…
  2. ステップ 2

    ベース URL を変更

    OpenAI の接続先を https://api.spicyapi.ai/v1 に置き換えます。

    base URL
    https://api.spicyapi.ai/v1
  3. ステップ 3

    モデル ID を選ぶ

    下の一覧からチャットモデルの ID をコピーして、最初のメッセージを送ります。

    model
    xai/grok-4.7/chat

変更するのは 3 つだけ

多くのクライアントは /chat/completions を自動で付け足すので、ベース URL は /v1 までを入力してください。完全なエンドポイントを求めるアプリでは、https://api.spicyapi.ai/v1/chat/completions を入力します。

クライアント別の設定

お使いの SDK、フレームワーク、アプリのスニペットをコピーしてください。 お使いのツールをクリックすると、そのスニペットへ移動します。

curl https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_CATALOG",
    "messages": [{ "role": "user", "content": "Write a two-line opening scene." }],
    "stream": true
  }'

サードパーティ製クライアントの設定形式は、バージョンによって変わることがあります。ここに載せたスニペットが合わなくなったときは、クライアント自身のドキュメントを優先してください。

使えるチャットモデル

ID は表示のとおりにコピーしてください。料金とコンテキストの上限は、各モデルのページにあります。

すべてのチャットモデル (26)

よくあるエラーの直し方

最初のつまずきは、たいていこの 3 つのどれかです。カードには、表示される内容と直すポイントを 1 つずつ載せています。

  • 401

    認証エラー

    キーがないか、OpenAI のキーを使っています。SpicyAPI のキーを送ってください:Authorization: Bearer sk-spicy-…

  • 404

    見つかりません

    ベース URL の階層がずれています。https://api.spicyapi.ai/v1 を指定してください。ドメインだけでも、/chat/completions を二重に付けても動きません。

  • モデル

    モデルが見つかりません

    gpt-4o のような OpenAI のモデル名は、ここではエイリアスになりません。maker/model/chat の形式の正式な ID を使ってください。

よくある質問