Skip to main content

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:
  1. SambaNova Account: Sign up at SambaNova Cloud
  2. API Key: Generate an API key from your account dashboard
  3. 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.
SambaNovaLLMService.Settings
default:"None"
Runtime-configurable settings. See Settings below.
str
default:"https://api.sambanova.ai/v1"
Base URL for SambaNova API endpoint.
The constructor also accepts 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 the settings 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 developer message role. Messages with this role are sent as user messages.
  • 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_tokens and reasoning_tokens when available from the provider.
  • SambaNova is known for high-throughput inference on large language models.