Changelog

Model library

Truss examples

Baseten

API reference

Truss reference

Chains reference 🆕

Go to workspace

Status

Support

Creates a new secret or updates an existing secret if one with the provided name already exists. The name and creation date of the created or updated secret is returned.

Upsert a secret

A request to create or update a Baseten secret by name.

UpsertSecretRequestV1

ApiKeyAuth

A Baseten secret. Note that we do not support retrieving secret values.

SecretV1

Upserts a secret

Fast, scalable inference in our cloud or yours

Welcome to Baseten!

Deploy your first model

Model deployment overview

Getting Started

LLM with Streaming

Text-to-image

Deploy a language model, with the model weights cached at build time

Fast Cold Starts with Cached Weights

Load a model that requires authentication with Hugging Face

Private Hugging Face Model

Deploy a model with both Python and system dependencies

Model with system packages

A guide to configuring a base image for your truss

How to use base images

Load model weights without Hugging Face or S3

How to load model weights

Deploy a model that makes use of pre-process

Pre/post-process methods

LLM with streaming output

A guide on configuring your truss to use external packages

How to use external packages

How to run your own docker commands during the build stage

How to run custom docker commands

Private Hugging Face model

Enable fast cold starts for a model with private Hugging Face weights

Deploy Llama 2 with Caching

A guide to setting concurrency for your model

How to configure concurrency

Accelerate cold starts by caching your weights

How to cache model weights

A guide to using secrets securely in your ML models

How to use secrets

Development vs production

Serve your model on the right instance type

How to set GPU resources

Scale from internal testing to the top of Hacker News

How to configure autoscaling

Fixing common problems during model deployment

Deployment troubleshooting

How to call your model

Run asynchronous inference on deployed models

Async inference user guide

Secure the asynchronous inference results sent to your webhook

Securing async inference

How to stream model output

How to parse base64 output

How to do model I/O in binary

How to do model I/O with files

Use your Baseten models with tools like LangChain

Baseten model integrations

Fixing common problems during model invocation

Invocation troubleshooting

A new DX for deploying multi-component ML workflows

Chains overview

Build your first Chain

User Guide

Glossary of Chains concepts and terminology

Concepts

Build a RAG (retrieval-augmented generation) pipeline with  Chains

RAG Chain

Transcribe hours of audio to text in a few seconds

Audio Transcription Chain

Engineering your Truss and application for faster cold starts

How to get faster cold starts

Handle variable throughput with this autoscaling parameter

How to set concurrency

Specs and recommendations for every instance type on Baseten

Instance type reference

Understand the load and performance of your model

Reading model metrics

Monitoring model health

Secure model inference

Share your Baseten workspace with your team

Workspace access control

Best practices for API keys

Securely store and access passwords, tokens, keys, and more

Best practices for secrets

Manage payments and track overall Baseten usage

Billing and usage

Details on model inference and management APIs

Production deployment

Development deployment

Published deployment

ChatCompletions

ChatCompletions (deprecated)

Model endpoint migration guide

Call primary version

Call model version

Wake primary version

Wake model version

Use this endpoint to call the [production deployment](/deploy/lifecycle) of your model asynchronously.

Use this endpoint to call the [development deployment](/deploy/lifecycle) of your model asynchronously.

Use this endpoint to call any [published deployment](/deploy/lifecycle) of your model.

Use this endpoint to get the status of an async request.

Get async request status

Use this endpoint to cancel a queued async request.

Cancel async request

Get all secrets

Get all models

Get a model by ID

Get all model deployments

Gets a model's production deployment and returns the deployment.

Gets a model's development deployment and returns the deployment.

Gets a model's deployment by id and returns the deployment.

Any deployment by ID

Updates a production deployment's autoscaling settings and returns the update status.

Updates a development deployment's autoscaling settings and returns the update status.

Updates a deployment's autoscaling settings and returns the update status.

Creates a new production deployment from the development deployment, the currently building deployment is returned.

Promotes an existing deployment to production and returns the same deployment.

Activates an inactive production deployment and returns the activation status.

Activates an inactive development deployment and returns the activation status.

Activates an inactive deployment and returns the activation status.

Deactivates a production deployment and returns the deactivation status.

Deactivates a development deployment and returns the deactivation status.

Deactivates a deployment and returns the deactivation status.

Details on Truss CLI and configuration options

Set your model resources, dependencies, and more

Config options

TRT-LLM build configuration

The simplest way to serve models in production

truss

truss init

truss push

truss watch

truss predict

truss image

truss container

truss cleanup

Details on Chains CLI and configuration options

Inference API

Async Inference API

Management API

Upsert a secret

Authorizations

Body

Response