Apertis API

Apertis API

Apertis is an OpenAI-compatible API gateway providing access to 500+ AI models from 30+ providers (Anthropic, OpenAI, Google, DeepSeek, Mistral, MiniMax, GLM, and more).

Model IDs change frequently. Always check https://apertis.ai/pricing?utm_source=apertis-skills&utm_medium=skill-doc&utm_campaign=ecosystem for the current model list and pricing.

Quick Start — One Line to Switch

from openai import OpenAI

client = OpenAI(
    base_url="https://api.apertis.ai/v1",
    api_key="YOUR_APERTIS_KEY"
)

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://api.apertis.ai/v1",
  apiKey: process.env.APERTIS_API_KEY,
});

Authentication

• Get your API key at https://apertis.ai?utm_source=apertis-skills&utm_medium=skill-doc&utm_campaign=ecosystem
• Header: Authorization: Bearer YOUR_APERTIS_KEY
• Keys start with sk- (PAYG) or sk-sub_ (subscription plans)

API Endpoints

All OpenAI-compatible endpoints are supported:

Model Families

Apertis carries the latest models from every major provider. Use GET /v1/models or visit https://apertis.ai/pricing?utm_source=apertis-skills&utm_medium=skill-doc&utm_campaign=ecosystem for the full current list.

Web Search — :web Suffix

Add :web to any model ID to enable real-time web search:

response = client.chat.completions.create(
    model="gpt-4o:web",
    messages=[{"role": "user", "content": "What happened in AI news today?"}]
)

# Response includes a top-level web_sources array (on the response, not inside choices[].message)
sources = response.web_sources
# [{"title": "...", "url": "...", "snippet": "..."}]

Note: :free models cannot use :web suffix.

Example: Chat Completion

response = client.chat.completions.create(
    model="claude-sonnet-4-6",   # check apertis.ai/pricing for latest Claude Sonnet ID
    messages=[
        {"role": "system", "content": "You are a helpful coding assistant."},
        {"role": "user", "content": "Write a Python function to reverse a linked list."}
    ]
)
print(response.choices[0].message.content)

Example: Streaming

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Explain async/await in JavaScript"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Example: Embeddings

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="Your text to embed"
)
vector = response.data[0].embedding

Vercel AI SDK — Native Provider

For TypeScript apps and agents built on the Vercel AI SDK (v5+), use the native Apertis provider instead of the raw OpenAI SDK. Works with OpenCode, Kilo Code, Cursor, and any AI-SDK-based tool.

npm install @apertis/ai-sdk-provider ai

import { apertis } from "@apertis/ai-sdk-provider";
import { generateText } from "ai";

const { text } = await generateText({
  model: apertis("claude-sonnet-4-6"),   // any of 500+ models
  prompt: "Explain quantum computing in simple terms.",
});

Streaming, tool calling, and embeddings all work through the standard AI SDK functions (streamText, tool, embed). Set APERTIS_API_KEY in the environment, or pass it explicitly:

import { createApertis } from "@apertis/ai-sdk-provider";

const apertis = createApertis({ apiKey: process.env.APERTIS_API_KEY });

MCP Server Setup

Use Apertis directly from Claude Code, Cursor, or any MCP-compatible client:

{
  "mcpServers": {
    "apertis": {
      "command": "npx",
      "args": ["-y", "@apertis/mcp-server"],
      "env": {
        "APERTIS_API_KEY": "YOUR_APERTIS_KEY"
      }
    }
  }
}

Place in Claude Code (~/.claude.json), Cursor (.cursor/mcp.json), or Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json).

Subscription Plans

PAYG (pay-as-you-go) is also available with no monthly commitment.

Resources

• Full model list & pricing: https://apertis.ai/pricing?utm_source=apertis-skills&utm_medium=skill-doc&utm_campaign=ecosystem
• MCP Package: https://www.npmjs.com/package/@apertis/mcp-server
• Support: hi@apertis.ai