Apertis Docs

SDKs & Libraries

Apertis Python SDK

Official Python SDK for the Apertis AI API, providing a comprehensive interface to the models available to your Apertis API key through a unified, type-safe library.

Updated
Reading time
2 min
Edit this page

On this page

Features

  • Sync and Async Support - Both synchronous and asynchronous clients for flexible integration
  • Streaming - Real-time response streaming for chat completions
  • Tool Calling - Function/tool calling support for building AI agents
  • Embeddings - Text embedding generation with batch processing
  • Vision - Image analysis with multimodal models
  • Audio - Text to speech, transcription and translation (client.audio), plus audio input and output in chat
  • Video - Video content analysis capabilities
  • Web Search - Real-time web search with citation support
  • Reasoning - Chain-of-thought reasoning and extended thinking
  • Messages API - Anthropic-native message format, with streaming and extended thinking
  • Responses API - OpenAI Responses API format, with response.output_text
  • Rerank - client.rerank.create() exists, but the endpoint is not currently available
  • Full Type Hints - Complete type annotations for IDE support
  • Automatic Retries - Built-in retry logic for transient errors

Installation

pip install apertis

The pages below describe apertis 0.4.1. Run pip install -U apertis to upgrade an older install.

Setup

Get your API Key from Apertis

export APERTIS_API_KEY=sk-your-api-key

Code Configuration

from apertis import Apertis

# Uses APERTIS_API_KEY environment variable automatically
client = Apertis()

# Or provide API key directly
client = Apertis(api_key="sk-your-api-key")

Quick Start

from apertis import Apertis

def main():
    client = Apertis()

    response = client.chat.completions.create(
        model="gpt-5.4-mini",
        messages=[
            {"role": "user", "content": "Hello! What can you help me with?"}
        ]
    )

    print(response.choices[0].message.content)

if __name__ == "__main__":
    main()

Supported Models

Access models from multiple providers through a single API:

Provider Example Models
OpenAI gpt-5.5, gpt-5.4-mini, o4-mini-high, o3-mini-high
Anthropic claude-sonnet-4-6, claude-opus-4-5-20251101, claude-haiku-4.5
Google gemini-3.1-pro-preview, gemini-2.5-flash, gemini-2.0-flash-001
DeepSeek deepseek-v3.2, deepseek-r1
xAI grok-4.3, grok-4-fast
Current catalog View models available to your key

Feature Documentation

Resources