Fireworks AIを接続する ​

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

Fireworks AIは、Llama、DeepSeek、Qwen、Kimi、GLMなどのオープンウェイトモデルを、OpenAI互換APIの背後でホストします。 Fireworks AIが提供するオープンウェイトモデルへのリクエストをルートするために、Fireworks AIのAPIキーをModel Gatewayに接続します。

Model Gatewayは、Fireworks AIのAPIキーをproviderコネクションの中に保存します。アプリケーションはFireworks AIのAPIキーの代わりにModel Gatewayのaccess keysで認証し、policiesによってレート制限、トークン上限、IP制限が適用されます。これらは他のあらゆるプロバイダーに対するものと同様に、Fireworks AIトラフィックにも適用されます。

機能の提供状況

Model Gatewayは、一部のお客様のみご利用いただけます。ご利用のワークスペースで利用可能かどうかを確認するには、Customer Success Representativeにお問い合わせください。

前提条件 ​

Fireworks AIをModel Gatewayに接続するには、次の要件が必要です。

  • 利用可能なクレジットを持つFireworks AIアカウント。 Fireworks AIはクレジットがないアカウントを停止し、停止されたアカウントではAPIキーの作成やリクエスト送信は行えません。 Billingでクレジットまたは支払い方法を追加します。
  • Workatoワークスペース内のModel Gatewayへのアクセス権

Fireworks AI APIの詳細 ​

Model GatewayはFireworksプロバイダータイプを通じてFireworks AIに接続し、次の値を使用します:

設定値
API URLhttps://api.fireworks.ai/inference/v1(デフォルト)
認証ベアラートークンとして送信されるFireworks AI APIキー
モデルIDの形式accounts/fireworks/models/<model-name>。例: accounts/fireworks/models/gpt-oss-120b

Fireworks AI APIの詳細については、Fireworks AI OpenAI compatibility documentationを参照してください。

Fireworks AI APIキーを作成する ​

Fireworks AIでAPIキーを作成するには、次の手順を実行します。

1

Fireworks AIにサインインし、Settings > API Keysに移動します。

2

Create API Keyをクリックし、API Keyを選択します。

Select API KeyAPI Keyを選択

サービスアカウントAPIキー

本番環境ではService Account API Keysの利用を検討してください。 Fireworks AIは、バックエンドサービスや自動化されたワークフローにはサービスアカウントの使用を推奨しており、監査ログではユーザーアクティビティとは別にサービスアカウントのアクティビティが表示されます。詳しくはFireworks AIドキュメントのService accountsを参照してください。

3

後から識別できるように、API Key Nameフィールドにキー名を入力します。例えばWorkato Model Gatewayなどです。

Create a Fireworks AI API keyFireworks AI APIキーを作成

4

任意。キーの有効期限を設定するには、Set expiration dateを選択します。キーは既定で1年後に期限切れになります。

キーの有効期限

Fireworks AI APIキーの有効期限が切れると、Model Gateway経由のリクエストは失敗します。有効期限前に新しいキーを作成し、そのキーを入力するようにプロバイダーを編集します。

5

Generate Keyをクリックします。

6

Copy your API KeyダイアログのAPI Key値の横にあるコピーアイコンをクリックし、キーを安全な場所に保管します。 Model Gatewayにプロバイダーを追加する際に、このキーが必要です。

キーの表示は1回のみ

Fireworks AIはAPIキーを1回だけ表示します。 Closeをクリックする前にキーをコピーしてください。キーを紛失した場合は、新しいキーを作成してください。

Fireworks AIをプロバイダーとして追加する ​

Model GatewayでFireworks AIをプロバイダーとして追加するには、次の手順を実行します。

1

Model Gateway > プロバイダーに移動します。

2

+ プロバイダーを追加をクリックします。

3

コネクション nameフィールドにわかりやすい名前を入力します。例: Fireworks AI。

4

Locationドロップダウンメニューを使用して、このプロバイダーを保存するプロジェクトまたはフォルダを選択します。

5

Connection typeドロップダウンメニューでCloudが選択されたままにします。

6

LLM Providerドロップダウンメニューを使用して、Fireworksを選択します。

Configure your Fireworks AI providerFireworks AIプロバイダーを構成

7

API KeyフィールドにFireworks AIのAPIキーを入力します。

8

任意。 APIバージョンを含めたAPIベースURLをAPI URLフィールドに入力します。 Fireworks AIのデフォルトhttps://api.fireworks.ai/inference/v1を使用する場合は、このフィールドを空白のままにします。

9

接続をクリックします。

作成したプロバイダーは、ProvidersリストにConnectedステータスで表示されます。

API URLにhttps://api.fireworks.ai/inference/v1を指定したOpenAI Compatibleプロバイダータイプを使用する既存のプロバイダーは、そのまま動作します。再作成する必要はありません。

Fireworks AIモデルIDを見つける ​

各ルートは1つのFireworks AIモデルにリクエストを送信します。どのモデルに送信するかは、ルートのModelフィールドにモデルIDを指定して決定します。 ModelフィールドにはFireworks AIモデルが候補として表示され、モデルライブラリでは各モデルの機能が表示されるため、候補から選択したり、候補にないモデルを探したりできます。 Fireworks AIは各モデルを表示名ではなく完全なパスで識別します。

モデルIDを見つけるには、次の手順を実行します。

1

Fireworks AI model libraryに移動し、使用する予定のモデルをクリックします。

2

モデル名の下に表示されているmodel pathラベルの値をコピーします。例えばaccounts/fireworks/models/gpt-oss-120bです。この値がモデルIDです。

3

Supporting Functionalityの下で、ServerlessがSupportedとして記載されていることを確認します。サーバーレスモデルはトークン単位で課金され、Fireworks AI側でのセットアップは不要です。

Fireworks AIモデルのサポート内容はモデルによって異なります。例えば、一部のモデルのみが関数呼び出しや画像入力をサポートします。プロダクション環境のトラフィックをルートする前に、そのモデルのページでSupporting Functionalityを確認してください。

Fireworks AIモデルへのルートを作成する ​

直接ルートは、すべてのリクエストを同じプロバイダーとモデルに送信します。 Fireworks AIモデルへのダイレクトルートを作成するには、次の手順を実行します。

1

Model Gateway > ルートに移動し、+ ルートを作成をクリックします。

2

Select route typeフィールドでDirectを選択します。

3

Route name(ルート名)フィールドに名前を入力します。 Model Gatewayは、ルート名からルートIDを生成します。アプリケーションは、リクエスト内のmodel値としてルートIDを使用します。

Configure your routeルートを構成

4

Locationドロップダウンメニューを使用して、このルートを保存するプロジェクトまたはフォルダを選択します。

5

Providerドロップダウンメニューで、作成済みのFireworks AIプロバイダーを選択します。

6

Modelフィールドでモデルを選択するか、モデルIDを手動で入力します。例えばaccounts/fireworks/models/gpt-oss-120bです。

このリストには、埋め込みモデルやリランカーモデルなど、チャットリクエストをサポートしないモデルが含まれる場合があります。選択する前に、Fireworks AIのモデルライブラリでモデルの機能を確認してください。 Fireworks AIモデルIDを見つけるを参照してください。

7

任意。 Policyドロップダウンメニューを使用して、このルートの使用を管理するポリシーを選択します。

8

Createをクリックします。

ルールベースおよびインテリジェントなルートを作成するには、Routesを参照してください。例えば、ルールベースのルートを使用して、特定のチームからのリクエストをFireworks AIモデルに送信し、それ以外のリクエストを別のプロバイダーに送信できます。ルールを定義するには、Route builderを参照してください。

アクセスキーの作成 ​

Fireworks AIルートを含むアクセスキーを作成します。アプリケーションは、Fireworks AIのAPIキーの代わりに、このキーを使用してModel Gatewayで認証します。アクセスキーを作成を参照してください。

Fireworks AIモデルにリクエストを送信する ​

Model Gatewayのアクセスキーで認証し、model値としてルートIDを渡します。 Model Gatewayはルートを解決してFireworks AIプロバイダーおよびモデルを特定し、割り当てられたポリシーを適用したうえで、保存されているFireworks AI APIキーを使用してFireworks AIにリクエストを転送します。

レスポンス内のmodelフィールドには、リクエストを処理したFireworks AIモデルが表示されます。例えばaccounts/fireworks/models/gpt-oss-120bです。

Model Gatewayは、Fireworks AIをバックエンドに持つルートに対して、Anthropic互換のリクエストも受け付けます。 Anthropic互換の例についてはTest a routeを、Claude CodeおよびAnthropic SDKの設定についてはConnect clientsを参照してください。

Fireworks AIの動作 ​

次の動作は、Model Gateway経由で送信されるFireworks AIへのリクエストに適用されます。

  • コンテキスト長: Fireworks AIは、プロンプトとmax_tokensの合計がモデルのコンテキストウィンドウを超えた場合、デフォルトでmax_tokensを減らします。 OpenAIは代わりにエラーを返します。エラーを返したい場合は、リクエストボディでcontext_length_exceeded_behaviorをerrorに設定します。
  • 関数呼び出し: Fireworks AIは、対応しているモデル上でOpenAI互換の関数呼び出しをサポートします。関数呼び出しや並列関数呼び出しに依存する前に、対象モデルの機能一覧を確認してください。
  • 推論モデル: gpt-oss-120bなどの推論モデルは、回答を含むcontentフィールドに加えて、レスポンスメッセージのreasoning_contentフィールドに推論過程を返します。
  • ストリーミング: Fireworks AIはストリーミングレスポンスをサポートします。 Model GatewayはエンドツーエンドでServer-Sent Events(SSE)をサポートしているため、Fireworks AIからのストリーミングレスポンスは段階的に配信されます。

Fireworks AIモデルの利用状況および課金は、あなたのFireworks AIアカウントに対して適用されます。モデルの料金およびレート制限については、Fireworks AI documentationを参照してください。

トラブルシューティング ​

Fireworks AIルートへのリクエストが失敗した場合は、次のトラブルシューティング情報を使用して解決します。 Fireworks AIから返されるエラーレスポンスには"error_from_provider": trueが含まれ、error.messageフィールドにFireworks AIのエラーメッセージが入ります。このフィールドが含まれていないエラーはModel Gatewayからのものであり、その場合リクエストはFireworks AIに到達していません。

アクセスキーが拒否されました ​

Model Gatewayは、Authorizationヘッダー内のアクセスキーを認識できない場合、401とcan't authorize request: invalid credentialsというメッセージを返します。このエラーは、多くの場合、ヘッダーに改行などの余分な文字が含まれている場合や、キーを複数回貼り付けた場合に発生します。ヘッダーが完全なアクセスキーを含むBearer <access-key>形式になっていることを確認するか、元のアクセスキーがない場合は新しいアクセスキーを作成します。

プロバイダーに到達できません ​

プロバイダーの追加または編集時にプロバイダーへ到達できない場合、Model GatewayはError 503を返します。 API URLフィールドが空白であるか、https://api.fireworks.ai/inference/v1に設定されていることを確認し、再度ConnectまたはSaveをクリックします。

Fireworks AI APIキーが拒否されました ​

プロバイダーに設定されたFireworks AI APIキーが無効または有効期限切れの場合、Fireworks AIはThe API key you provided is invalid.というメッセージを返します。 Fireworks AIでキーが有効になっていることを確認し、必要に応じて新しいキーを入力するようにプロバイダーを編集します。

OpenAI Compatibleプロバイダータイプを使用するプロバイダーでAPI URLフィールドが空白の場合も、同様のエラーが返されます。空白のAPI URLはリクエストをOpenAIに送信し、OpenAIはIncorrect API key providedというメッセージでFireworks AIのAPIキーを拒否します。プロバイダーを編集してAPI URLフィールドにhttps://api.fireworks.ai/inference/v1を入力するか、Fireworksプロバイダータイプで新しいプロバイダーを追加します。

Fireworks AIアカウントが停止されています ​

Fireworks AIはクレジットがないアカウントを停止し、その場合account is suspended due to CREDIT_DEPLETEDというメッセージを返します。アカウントを再有効化するには、Fireworks AIのBillingでクレジットまたは支払い方法を追加します。

モデルが見つかりません ​

ルートのModelフィールドがFireworks AIで提供されているモデルと一致しない場合、Fireworks AIはModel not found, inaccessible, and/or not deployedというメッセージを返します。このエラーは、フィールドにモデルIDではなく表示名が入力されている場合や、そのモデルがサーバーレスに対応していない場合に発生します。ルートを編集し、Modelフィールドに、accounts/fireworks/models/gpt-oss-120bのような完全なモデルパスを使用していることを確認します。モデルがサーバーレスに対応していることを確認するには、Fireworks AIモデルIDを見つけるを参照してください。

ルートが見つかりません ​

リクエストのmodel値に含まれるルートIDが見つからない場合、Model Gatewayは404とmodel "<route-id>" not foundというメッセージを返します。 model値がルートのRoute IDと一致していることを確認します。次に、アクセスキーのRoute(s)リストにそのルートが含まれていることを確認し、必要に応じてアクセスキーを編集してルートを追加します。

最終更新日: