API Reference

OpenAI-compatible. Switch in 30 seconds.

🚀 Overview

OneAI provides an OpenAI-compatible API. If you already use the OpenAI SDK, just change base_url and api_key — everything else works identically.

Base URL
https://api.oneai.io/v1
Auth Header
Authorization: Bearer oneai-sk-...

🔑 Authentication

All API requests require an API key. Get yours from the dashboard.

# Option 1: Environment variable
export ONEAI_API_KEY="oneai-sk-your-key-here"

# Option 2: Pass directly in code
import openai
client = openai.OpenAI(
    api_key="oneai-sk-your-key-here",
    base_url="https://api.oneai.io/v1"
)

💬 Chat Completions

POST /v1/chat/completions

Send a conversation and get a model response.

from openai import OpenAI

client = OpenAI(
    api_key="oneai-sk-...",
    base_url="https://api.oneai.io/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain quantum computing in simple terms."}
    ],
    temperature=0.7,
    max_tokens=1024
)

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

Parameters

ParameterTypeDescription
modelstringModel ID (e.g. deepseek-v4-pro)
messagesarrayConversation history
temperaturefloat0-2. Higher = more random
max_tokensintMax output length
streambooleanEnable streaming

📡 Streaming

Stream responses token-by-token for real-time output.

stream = client.chat.completions.create(
    model="deepseek-v3",
    messages=[{"role": "user", "content": "Write a haiku about AI"}],
    stream=True
)

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

🧠 Available Models

Model IDProviderContextInput/1MOutput/1M
deepseek-v4-proDeepSeek128K$1.00$4.00
deepseek-v4-flashDeepSeek128K$0.30$1.20
deepseek-r1DeepSeek128K$0.80$3.50
deepseek-v3DeepSeek128K$0.50$2.19
deepseek-r1DeepSeek128K$0.55$2.19
qwen-coderAlibaba128K$0.40$1.60
qwen-maxAlibaba32K$0.60$2.40
kimiMoonshot128K$0.40$1.60
minimax-m1MiniMax1M$0.35$1.40
glm-4Zhipu128K$0.30$1.20

⚠️ Error Codes

401Invalid or missing API key
402Insufficient balance — top up your account
429Rate limit exceeded — slow down or upgrade
500Server error — we're on it. Retry with backoff
503Model overloaded — try again or switch models

⏱ Rate Limits

TierRPMTPMConcurrent
Free20200K2
Pro2002M10
EnterpriseCustomCustomCustom

Ready to build?

Get your API key and start in 30 seconds.

Get Free Credits →