Skip to main content

CompactifAI

https://docs.compactif.ai/

CompactifAI offers highly compressed versions of leading language models, delivering up to 70% lower inference costs, 4x throughput gains, and low-latency inference with minimal quality loss (under 5%). CompactifAI's OpenAI-compatible API makes integration straightforward, enabling developers to build ultra-efficient, scalable AI applications with superior concurrency and resource efficiency.

PropertyDetails
DescriptionCompactifAI offers compressed versions of leading language models with up to 70% cost reduction and 4x throughput gains
Provider Route on LiteLLMcompactifai/ (add this prefix to the model name - e.g. compactifai/cai-llama-3-1-8b-slim)
Provider DocCompactifAI ↗
API Endpoint for Providerhttps://api.compactif.ai/v1
Supported Endpoints/chat/completions, /completions

Supported OpenAI Parameters​

CompactifAI is fully OpenAI-compatible and supports the following parameters:

"stream",
"stop",
"temperature",
"top_p",
"max_tokens",
"presence_penalty",
"frequency_penalty",
"logit_bias",
"user",
"response_format",
"seed",
"tools",
"tool_choice",
"parallel_tool_calls",
"extra_headers"

API Key Setup​

CompactifAI API keys are available through AWS Marketplace subscription:

  1. Subscribe via AWS Marketplace
  2. Complete subscription verification (24-hour review process)
  3. Access MultiverseIAM dashboard with provided credentials
  4. Retrieve your API key from the dashboard
import os

os.environ["COMPACTIFAI_API_KEY"] = "your-api-key"

Usage​

from litellm import completion
import os

os.environ['COMPACTIFAI_API_KEY'] = "your-api-key"

response = completion(
    model="compactifai/cai-llama-3-1-8b-slim",
    messages=[
       {"role": "user", "content": "Hello from LiteLLM!"}
   ],
)
print(response)

Streaming​

from litellm import completion
import os

os.environ['COMPACTIFAI_API_KEY'] = "your-api-key"

response = completion(
    model="compactifai/cai-llama-3-1-8b-slim",
    messages=[
       {"role": "user", "content": "Write a short story"}
   ],
    stream=True
)

for chunk in response:
    print(chunk)

Advanced Usage​

Custom Parameters​

from litellm import completion

response = completion(
    model="compactifai/cai-llama-3-1-8b-slim",
    messages=[{"role": "user", "content": "Explain quantum computing"}],
    temperature=0.7,
    max_tokens=500,
    top_p=0.9,
    stop=["Human:", "AI:"]
)

Function Calling​

CompactifAI supports OpenAI-compatible function calling:

from litellm import completion

functions = [
    {
        "name": "get_weather",
        "description": "Get current weather information",
        "parameters": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "The city and state"
                }
            },
            "required": ["location"]
        }
    }
]

response = completion(
    model="compactifai/cai-llama-3-1-8b-slim",
    messages=[{"role": "user", "content": "What's the weather in San Francisco?"}],
    tools=[{"type": "function", "function": f} for f in functions],
    tool_choice="auto"
)

Async Usage​

import asyncio
from litellm import acompletion

async def async_call():
    response = await acompletion(
        model="compactifai/cai-llama-3-1-8b-slim",
        messages=[{"role": "user", "content": "Hello async world!"}]
    )
    return response

# Run async function
response = asyncio.run(async_call())
print(response)

Available Models​

CompactifAI offers compressed versions of popular models. Use the /models endpoint to get the latest list:

import httpx

headers = {"Authorization": f"Bearer {your_api_key}"}
response = httpx.get("https://api.compactif.ai/v1/models", headers=headers)
models = response.json()

Common model formats:

  • compactifai/cai-llama-3-1-8b-slim
  • compactifai/mistral-7b-compressed
  • compactifai/codellama-7b-compressed

Benefits​

  • Cost Efficient: Up to 70% lower inference costs compared to standard models
  • High Performance: 4x throughput gains with minimal quality loss (under 5%)
  • Low Latency: Optimized for fast response times
  • Drop-in Replacement: Full OpenAI API compatibility
  • Scalable: Superior concurrency and resource efficiency

Error Handling​

CompactifAI returns standard OpenAI-compatible error responses:

from litellm import completion
from litellm.exceptions import AuthenticationError, RateLimitError

try:
    response = completion(
        model="compactifai/cai-llama-3-1-8b-slim",
        messages=[{"role": "user", "content": "Hello"}]
    )
except AuthenticationError:
    print("Invalid API key")
except RateLimitError:
    print("Rate limit exceeded")

Support​