xidao-ai 1.0.0

Official Python SDK for XiDao AI API Gateway

XiDao AI API Gateway - Python SDK

Official Python SDK for XiDao AI API Gateway - Access Claude 4.7, GPT-5.5, Gemini 3.0 and more through a single API.

Installation

pip install xidao-ai

Quick Start

from xidao_ai import XiDao

# Initialize client
client = XiDao(api_key="your_api_key")

# Chat completion
response = client.chat.completions.create(
    model="claude-4.7",
    messages=[{"role": "user", "content": "Hello!"}]
)

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

Available Models

• Claude 4.7 - Best for reasoning and analysis
• GPT-5.5 - Universal model from OpenAI
• Gemini 3.0 - Best price/performance ratio
• DeepSeek V3 - Powerful open-source model
• Qwen Max - Excellent for Chinese language

Features

• ✅ OpenAI-compatible API
• ✅ Automatic model routing
• ✅ Response caching
• ✅ Rate limiting handling
• ✅ Async support
• ✅ Type hints

Advanced Usage

List Available Models

models = client.models.list()
for model in models:
    print(f"{model.id}: {model.owned_by}")

Async Client

import asyncio
from xidao_ai import AsyncXiDao

async def main():
    client = AsyncXiDao(api_key="your_api_key")
    
    response = await client.chat.completions.create(
        model="gpt-5.5",
        messages=[{"role": "user", "content": "Hello!"}]
    )
    
    print(response.choices[0].message.content)

asyncio.run(main())

Streaming

stream = client.chat.completions.create(
    model="claude-4.7",
    messages=[{"role": "user", "content": "Tell me a story"}],
    stream=True
)

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

Error Handling

from xidao_ai import XiDao, APIError, AuthenticationError

try:
    client = XiDao(api_key="invalid_key")
except AuthenticationError as e:
    print(f"Authentication failed: {e}")

try:
    response = client.chat.completions.create(
        model="invalid-model",
        messages=[{"role": "user", "content": "Hello"}]
    )
except APIError as e:
    print(f"API error: {e.status_code} - {e.message}")

Environment Variables

You can set your API key as an environment variable:

export XIDAO_API_KEY="your_api_key"

Then initialize the client without passing the key:

client = XiDao()  # Will use XIDAO_API_KEY environment variable

License

MIT License - see LICENSE for details.

Support

• 📧 Email: [e-mail]
• 📢 Telegram: @xidao_gateway
• 🐛 Issues: GitHub Issues

Links

• XiDao AI API Gateway
• Documentation
• PyPI Package