API Documentation

🔌 API Endpoints

Authentication: Pass your API key via Authorization: Bearer YOUR_API_KEY or X-Api-Key: YOUR_API_KEY header.

🍎 Xcode Setup (Apple Intelligence / Custom LLM)

Xcode 26+ lets you point Apple Intelligence at a custom OpenAI-compatible endpoint. Configure it as follows:

  1. Open Xcode → Settings → Generative AI (or Features → Generative AI depending on your version).
  2. Set Base URL to:
    https://ai.techxartisan.com/api
    ⚠️ Do NOT include /v1 — Xcode appends it automatically. Using /api/v1 here will result in /api/v1/v1/models (404).
  3. Paste your API Key into the API Key field.
    (Get yours from the API Keys page.)
  4. Pick a Model from the dropdown.
    The list is fetched from GET /api/v1/models.
  5. Click Test Connection — if everything is correct, you'll get a green checkmark and the model list will populate.
Common pitfall: If Xcode reports "Cannot fetch models" or "Provider is not valid":
  • Base URL is https://ai.techxartisan.com/api — not https://ai.techxartisan.com/api/v1
  • API key is in the right field (no extra whitespace)
  • Your account is active (check the Dashboard)

💻 Quick Start — curl Examples

OpenAI format — works with any OpenAI SDK, LangChain, Cursor, etc. 

# Non-streaming
curl https://ai.techxartisan.com/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.7-plus",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": false
  }'

# Streaming
curl https://ai.techxartisan.com/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.7-plus",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

Anthropic format — works with Claude CLI, Claude Code, Anthropic SDK. 

curl https://ai.techxartisan.com/api/v1/messages/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

🤖 Available Models

Pass any of these names as the model field in your request. The router will pick the best upstream supplier automatically.

DeepSeek-V4-Pro flagship
GLM-5.2 flagship
Kimi-K2.7-Code flagship
MiniMax-M3 flagship 👁 💭
MiniMax/MiniMax-M3 flagship 👁 💭
Qwen3.7-Max flagship
Qwen3.7-Plus flagship
deepseek-ai/DeepSeek-V4-Pro flagship 💭
deepseek-ai/deepseek-v4-pro flagship
deepseek-v4-pro flagship 💭
glm-5-agentic flagship
glm-5-thinking flagship
glm-5-thinking-agentic flagship
minimax-m2.5 flagship 👁 💭
minimax-m2.5-agentic flagship
minimax-m2.5-thinking flagship
minimax-m2.5-thinking-agentic flagship
minimaxai/minimax-m3 flagship
qwen3-coder-next flagship
qwen3-coder-next-agentic flagship
qwen3-coder-next-thinking flagship
qwen3.7-plus flagship 👁 💭
deepseek-v4-flash-free free
mimo-v2.5-free free
DeepSeek-V4-Flash standard
deepseek-ai/DeepSeek-V4-Flash standard 💭
deepseek-ai/deepseek-v4-flash standard
deepseek-v4-flash standard 💭
kimi-k2.5 standard 👁
moonshotai/Kimi-K2.5 standard
qwen3.5-plus standard 👁
qwen3.6-plus standard

✨ Features

  • Smart routing — requests are automatically load-balanced across multiple suppliers with failover.
  • Cross-model fallback — if the requested model is unavailable, the router falls back to a model in the same tier (flagship / standard / free).
  • Format conversion — send requests in either OpenAI or Anthropic format; the router translates as needed.
  • Token compression — RTK (input) and Caveman (output) compression can be enabled per-client in the admin panel.
  • Streaming — SSE streaming is supported on both OpenAI and Anthropic endpoints.
  • Thinking / extended thinking — supported where the upstream model allows it (look for 💭 in the model list).