Overview
SambaNovaLLMService provides access to SambaNova’s language models through an OpenAI-compatible interface. It inherits from OpenAILLMService and supports streaming responses, function calling, and context management with SambaNova’s high-performance inference platform.
SambaNova LLM API Reference
Pipecat’s API methods for SambaNova integration
Example Implementation
Complete example with function calling
SambaNova Documentation
Official SambaNova API documentation and features
SambaNova Cloud
Access models and manage API keys
Installation
To use SambaNova services, install the required dependencies:Prerequisites
SambaNova Account Setup
Before using SambaNova LLM services, you need:- SambaNova Account: Sign up at SambaNova Cloud
- API Key: Generate an API key from your account dashboard
- Model Selection: Choose from available high-performance models
Required Environment Variables
SAMBANOVA_API_KEY: Your SambaNova API key for authentication
Configuration
str
required
SambaNova API key for authentication. Raises
ValueError when empty.str
default:"None"
deprecated
Deprecated since 0.0.105, removed in 2.0.0. Use
settings=SambaNovaLLMService.Settings(model=...) instead.str
default:"https://api.sambanova.ai/v1"
Base URL for SambaNova API endpoint.
default_headers, retry_on_timeout, and
retry_timeout_secs, as described for
OpenAILLMService.
service_tier is accepted but not sent, so it has no effect.
Settings
Runtime-configurable settings passed via thesettings constructor argument using SambaNovaLLMService.Settings(...). These can be updated mid-conversation with LLMUpdateSettingsFrame. See Service Settings for details.
This service uses the same settings as OpenAILLMService. See OpenAI LLM Settings for the full parameter reference.
The default model is "Meta-Llama-3.3-70B-Instruct".
Usage
Basic Setup
With Custom Settings
Notes
- SambaNova does not support the
developermessage role. Messages with this role are sent asusermessages. - A tool call that arrives with empty arguments (rather than
{}) is skipped, so its function handler doesn’t run. When that call is the last one in the response, none of the response’s tool calls run. - Token usage reporting includes
cache_read_input_tokensandreasoning_tokenswhen available from the provider. - SambaNova is known for high-throughput inference on large language models.