Skip to main content
Fireworks AI serves open models through an OpenAI-compatible API, with two tiers:
  • Serverless: shared, per-token access to popular models. Fastest to start, subject to rate limits.
  • On-demand deployments: dedicated GPUs for one model, with no rate limits, fast autoscaling and a wider choice of models. You create them with the firectl CLI.
The one thing that differs from every other provider here is the model ID. Fireworks uses a full resource path, accounts/fireworks/models/<model>, and the short name on its own won’t work.

Set up Fireworks AI

1

Create an API key

In the Fireworks dashboard, open API keys, click Create API key and store it safely.
2

Copy the full model ID

Find a chat model in the Fireworks model library and copy its full ID, for example:
Note the Fireworks naming: versions are written with p for the decimal point, so Llama 3.1 is llama-v3p1.
3

Choose Fireworks AI in Bolna

Go to Settings → Integrations → LLM → Custom LLM → Add model, or choose + Add custom LLM in an agent’s LLM Provider dropdown. Select Fireworks AI. The hint under the endpoint field reminds you to use the full model ID.
Bolna Add custom model dialog with Fireworks AI selected, api.fireworks.ai/inference/v1 as the endpoint placeholder and a hint to use accounts/fireworks/models/ model IDs

Fireworks AI selected, with the full model ID hint

4

Register the model

  • Model name: the full path, for example accounts/fireworks/models/llama-v3p1-8b-instruct
  • Endpoint URL: https://api.fireworks.ai/inference/v1. The /inference segment is required.
  • API key: your Fireworks key
  • Family: for example llama
Add custom model dialog with Fireworks AI selected, model accounts/fireworks/models/llama-v3p1-8b-instruct, endpoint api.fireworks.ai/inference/v1, masked key and family llama

Fireworks AI serverless model, filled in

5

Select it on the agent

Choose custom on the Intelligence tab, pick the model and save.

Moving to an on-demand deployment

When a campaign starts hitting serverless rate limits, or you need a model that isn’t on serverless, create an on-demand deployment:
firectl prints the deployment’s Name, in the form accounts/<account-id>/deployments/<deployment-id>. Fireworks routes a request to your deployment when the model ID ends in # plus that name:
Register that string as the model name in Bolna, with the same endpoint URL and API key.
--min-replica-count 0 lets the deployment scale to zero, and the next call then waits for a GPU to start. For live voice traffic, keep at least one replica with --min-replica-count 1.

Troubleshooting

You probably entered a short name such as llama-v3p1-8b-instruct. Use the full accounts/fireworks/models/... path.
The endpoint must include /inference: https://api.fireworks.ai/inference/v1.
Serverless has rate limits. Move the agent to an on-demand deployment, which has none.