API Documentation

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-ama-YOUR_KEY',               // 1. Dashboard → API Keys
  baseURL: 'https://api.aimodelapi.ai/v1', // 2. Only change needed here
});

// Access any routed model:
const res = await client.chat.completions.create({
  model: 'claude-opus-4-7', // e.g. gpt-5.5, deepseek-v4-flash, gemini-3.1-pro
  messages: [{ role: 'user', content: 'Hello!' }],
});
console.log(res.choices[0].message.content);

from openai import OpenAI

client = OpenAI(
    api_key="sk-ama-YOUR_KEY",
    base_url="https://api.aimodelapi.ai/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4",
    messages=[{"role": "user", "content": "Explain transformers"}]
)
print(response.choices[0].message.content)

curl https://api.aimodelapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-ama-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.0-flash",
    "messages": [{"role": "user", "content": "What is 2+2?"}],
    "max_tokens": 100
  }'

const stream = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Write a haiku about AI' }],
  stream: true,
});

for await (const chunk of stream) {
  const delta = chunk.choices[0]?.delta?.content ?? '';
  process.stdout.write(delta);
}

# Primary — auto-selects nearest node (recommended)
BASE_URL = "https://api.aimodelapi.ai/v1"

# Regional — same OpenAI-compatible paths
BASE_URL = "https://sg.api.aimodelapi.ai/v1"   # Singapore
BASE_URL = "https://jp.api.aimodelapi.ai/v1"   # Tokyo
BASE_URL = "https://hk.api.aimodelapi.ai/v1"   # Hong Kong / China egress
BASE_URL = "https://th.api.aimodelapi.ai/v1"   # Bangkok
BASE_URL = "https://us.api.aimodelapi.ai/v1"   # US East (Virginia)
BASE_URL = "https://eu.api.aimodelapi.ai/v1"   # Frankfurt

from openai import OpenAI
client = OpenAI(api_key="sk-ama-YOUR_KEY", base_url=BASE_URL)

const res = await client.chat.completions.create({
  model: 'auto',
  messages: [{ role: 'user', content: 'Summarize this text in one sentence...' }],
});
console.log(res.model); // e.g. glm-5-flash or gemini-2.0-flash

const SMART_MODELS = {
  'ama/smart-code':    'Coding: frontier when needed, value tier for bulk edits',
  'ama/smart-write':   'Marketing & editorial copy',
  'ama/smart-reason':  'Long reasoning traces',
  'ama/smart-analyze': 'Structured analysis & summaries',
};

const res = await client.chat.completions.create({
  model: 'ama/smart-code',
  messages: [{ role: 'user', content: 'Refactor for O(n) complexity...' }],
});
console.log(`Used model: ${res.model}`);

const batchRes = await fetch('https://api.aimodelapi.ai/v1/batch', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk-ama-YOUR_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tier: 'batch_50',
    requests: [
      { custom_id: 'doc_1', model: 'deepseek-r1', messages: [{ role: 'user', content: 'Summarize...' }] },
    ],
    callback_url: 'https://yourapp.com/webhooks/batch',
  }),
});
const { poll_url } = await batchRes.json();

const result = await fetch(`https://api.aimodelapi.ai${poll_url}`, {
  headers: { 'Authorization': 'Bearer sk-ama-YOUR_KEY' },
});

// Dashboard → API Keys → BYOK tab registers your upstream keys.

// Standard credits: tuned for <$3/M workloads.
// BYOK: flatten routing to ~$0.50/M regardless of upstream list price.

const res = await client.chat.completions.create({
  model: 'claude-opus-4-7',
  messages: [{ role: 'user', content: 'Complex analysis...' }],
});