Quickstart

https://api.americanmodel.co/v1

Authorization: Bearer YOUR_API_KEY

POST /v1/chat/completions
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "messages": [
    {
      "role": "user",
      "content": "Write merge sort in 3 lines."
    }
  ]
}

POST /v1/chat/completions
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "messages": [
    {
      "role": "user",
      "content": "Write merge sort in 3 lines."
    }
  ],
  "model": [
    "{model1}",
    "{model2}"
  ]
}

{
  "result": {
    "content": "def merge_sort(arr):\n    if len(arr) <= 1: return arr\n    mid = len(arr) // 2\n    return merge(merge_sort(arr[:mid]), merge_sort(arr[mid:]))"
  },
  "session_id": "session_123",
  "selected_provider": {
    "model": "model1"
  }
}

import requests

API_KEY = "YOUR_API_KEY"
API_URL = "https://api.americanmodel.co/v1"

# Define your query message
messages = [
  {"role": "user", "content": "Write merge sort in 3 lines."}
]

# Option 1: Let the router choose the best model
response = requests.post(
    f"{API_URL}/chat/completions",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "messages": messages
    }
)

# Option 2: Specify preferred models
llm_providers = [
  "{model1}",
  "{model2}"
]
response = requests.post(
    f"{API_URL}/chat/completions",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "messages": messages,
        "model": llm_providers
    }
)

result = response.json()
print("Session ID:", result["session_id"])
print("Selected LLM:", result["selected_provider"]["model"])
print("Response:", result["result"]["content"])

const axios = require("axios");

const API_KEY = "YOUR_API_KEY";
const API_URL = "https://api.americanmodel.co/v1";

const messages = [
  { role: "user", content: "Explain how quantum genomics works." }
];

// Option 1: Let the router choose the best model
axios.post(
    `${API_URL}/chat/completions`,
    { messages },
    {
        headers: {
            Authorization: `Bearer ${API_KEY}`,
            "Content-Type": "application/json"
        }
    }
)
.then(({ data }) => {
    console.log("Session ID:", data.session_id);
    console.log("Selected LLM:", data.selected_provider.model);
    console.log("Response:", data.result.content);
})
.catch(error => {
    console.error("Error:", error.response?.data || error.message);
});

// Option 2: Specify preferred models
const llmProviders = [
    "{model1}",
    "{model2}"
];

axios.post(
    `${API_URL}/chat/completions`,
    {
        messages,
        model: llmProviders
    },
    {
        headers: {
            Authorization: `Bearer ${API_KEY}`,
            "Content-Type": "application/json"
        }
    }
)
.then(({ data }) => {
    console.log("Session ID:", data.session_id);
    console.log("Selected LLM:", data.selected_provider.model);
    console.log("Response:", data.result.content);
})
.catch(error => {
    console.error("Error:", error.response?.data || error.message);
});