Frequently Asked Questions

General Questions

What is Apertis?

Apertis is a unified API platform that provides access to models from OpenAI, Anthropic, Google, and other providers through a single, OpenAI-compatible interface. Instead of managing multiple provider keys and SDKs, you can use one Apertis API key and confirm the models currently available to that key through the live catalog.

How is Apertis different from using providers directly?

Is Apertis compatible with OpenAI SDK?

Yes! Apertis is fully compatible with the OpenAI SDK. You only need to change the base URL:

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-apertis-key",
    base_url="https://api.apertis.ai/v1"  # Only change needed
)

What models are available?

Apertis provides access to a changing multi-provider catalog that includes:

• OpenAI: GPT-5.5, GPT-5.4 Mini, GPT-5.4 Nano
• Anthropic: Claude Opus 4.8, Claude Sonnet 4.6, Claude Fable 5
• Google: Gemini 3.1 Pro, Gemini 3.5 Flash
• Open Source: Llama, Mistral, and more

View the current model catalog →

Account & Authentication

How do I get an API key?

1. Create an Apertis account or log in.
2. Choose a Coding Plan or add PAYG balance.
3. Open Settings → API Keys.
4. Click Create New Key and securely store the key.

I lost my API key. Can I recover it?

No, API keys are only displayed once when created. If you lose your key:

1. Create a new API key
2. Update your applications
3. Delete the old key for security

How many API keys can I create?

There's no strict limit. You can create multiple keys for different:

• Environments (dev, staging, production)
• Applications
• Team members

Can I share my API key?

We recommend creating separate keys for each user or application. This allows:

• Individual quota tracking
• Easy revocation if compromised
• Better security audit trails

Billing & Pricing

How does billing work?

Apertis offers two billing models:

1. Subscription Plans: Monthly quota with fixed pricing
2. Pay-As-You-Go (PAYG): Pay per token used

Learn more about billing →

What's the difference between subscription and PAYG?

How is usage calculated?

Usage is calculated per token:

Cost = (Input Tokens × Input Rate) + (Output Tokens × Output Rate)

Different models have different rates. View current pricing →

What happens when I run out of quota?

• Subscription: Enable PAYG fallback to continue, or wait for cycle reset
• PAYG: Add funds to continue

Do unused quotas roll over?

No, subscription quotas reset at each billing cycle and don't roll over.

Can I get a refund?

Contact support at hi@apertis.ai for refund requests. Refunds are handled case-by-case.

Technical Questions

What's the API base URL?

https://api.apertis.ai/v1

What's the rate limit?

Learn more about rate limits →

Do you support streaming?

Yes! Enable streaming with stream=True:

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Hello"}],
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content, end="")

What's the maximum context length?

It depends on the model:

Do you support function calling?

Yes, function calling is supported for compatible models:

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "What's the weather?"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "parameters": {...}
        }
    }]
)

Do you support vision (image input)?

Yes, for models that support it:

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "What's in this image?"},
            {"type": "image_url", "image_url": {"url": "https://..."}}
        ]
    }]
)

What audio formats are supported?

For speech-to-text: MP3, MP4, MPEG, MPGA, M4A, WAV, WebM

For text-to-speech: MP3, Opus, AAC, FLAC, WAV, PCM

Integrations

Does Apertis work with LangChain?

Yes:

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="gpt-5.5",
    openai_api_key="sk-your-key",
    openai_api_base="https://api.apertis.ai/v1"
)

Does Apertis work with Cursor/Cline/Continue?

Yes! Apertis works with all OpenAI-compatible tools:

• Cursor Integration
• Cline Integration
• Continue Integration

Can I use Apertis with my existing OpenAI code?

Yes, just change the base URL and API key. No other code changes needed.

Models & Features

Which model should I use?

Are model responses the same as direct providers?

Yes, Apertis routes requests to the actual providers. Responses are identical to what you'd get directly.

What is fallback models?

Fallback automatically switches to an alternative model if your primary model fails:

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[...],
    extra_body={
        "fallback_models": ["claude-sonnet-4-6", "gemini-3.1-pro-preview"]
    }
)

Learn more about fallback →

Is there a model playground?

Yes! Visit playground.apertis.ai to test models interactively.

Security & Privacy

Is my data secure?

Yes. We implement industry-standard security practices:

• HTTPS/TLS encryption for all connections
• API keys are encrypted at rest
• No logging of request/response content by default

Do you store my prompts or responses?

By default, we don't store prompt or response content. Only metadata (token counts, timestamps) is logged for billing.

Is Apertis SOC 2 compliant?

Contact support for compliance documentation and enterprise security features.

Can I restrict API key by IP?

Yes, you can set IP whitelists for each API key in the dashboard.

Troubleshooting

I'm getting 401 Unauthorized

• Check your API key is correct
• Ensure the Authorization: Bearer format is used
• Verify the key hasn't been deleted or expired

I'm getting 429 Too Many Requests

• You've hit the rate limit
• Wait and retry with exponential backoff
• Consider upgrading your plan for higher limits

I'm getting 402 Payment Required

• Your quota is exhausted
• Add funds (PAYG) or wait for cycle reset (subscription)
• Enable PAYG fallback for subscriptions

My requests are slow

• Use streaming for long responses
• Check your network connection
• Some models are slower than others

Full troubleshooting guide →

Account Management

How do I change my email?

1. Go to Account Settings
2. Click Change Email
3. Verify the new email address

How do I delete my account?

Contact support at hi@apertis.ai to request account deletion.

Can I have multiple accounts?

We recommend using a single account with multiple API keys instead of multiple accounts.

Support

How do I contact support?

• Email: hi@apertis.ai
• Dashboard: Submit a ticket

What are support hours?

We aim to respond within 24 hours on business days.

Is there a status page?

Yes: status.apertis.ai

Still have questions?

• Check our Troubleshooting Guide
• Review Error Codes
• Contact support at hi@apertis.ai