Using Cinna API with Eliza

Learn how to integrate and configure Cinna’s API with Eliza to unlock advanced AI capabilities for agentic systems on Solana.

Eliza allows developers to deploy autonomous agents. With Cinna, those agents can leverage powerful language models, image generation, and embeddings, all backed by decentralized infrastructure.

---

Prerequisites

Before getting started, ensure the following steps are complete:

• You have followed the Eliza quickstart setup

• You have requested your Cinna API key using the referral code agent in the application form

---

Environment Setup

Add the following variables to your .env file to activate Cinna API integration:

# Required Cinna API configuration
CINNA_API_KEY="<YOUR_CINNA_API_KEY>"
CINNA_MODEL=FLUX.1-dev
CINNA_EMBEDDING_MODEL=BAAI/bge-large-en-v1.5
USE_CINNA_EMBEDDING=true

# Optional configurations for model scaling
CINNA_MODEL_SMALL=your_small_model
CINNA_MODEL_MEDIUM=your_medium_model
CINNA_MODEL_LARGE=your_large_model

Agent Configuration

To direct Eliza to use Cinna models, include the following in your character configuration file:

{
  "modelProvider": "cinna"
}

Supported Models

Language Models For the complete list of supported LLMs, refer to the Cinna Language Model documentation.

Image Generation Cinna supports a range of image models optimized for speed, creativity, and cost-efficiency. See the Image Model documentation for full details.

Embeddings Currently supported:

• BAAI/bge-large-en-v1.5 This model is used by default for semantic embeddings and search operations.