List Models

curl --request GET \
  --url https://api.mixroute.ai/v1/models \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxx",
    base_url="https://api.mixroute.ai/v1"
)

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

const response = await fetch('https://api.mixroute.ai/v1/models', {
  headers: {
    'Authorization': 'Bearer sk-xxxxxxxxxx'
  }
});
const data = await response.json();
console.log(data.data);

<?php
$client = new GuzzleHttp\Client();
$response = $client->get('https://api.mixroute.ai/v1/models', [
    'headers' => [
        'Authorization' => 'Bearer sk-xxxxxxxxxx'
    ]
]);
echo $response->getBody();

package main

import (
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.mixroute.ai/v1/models", nil)
    req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
    http.DefaultClient.Do(req)
}

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mixroute.ai/v1/models"))
    .header("Authorization", "Bearer sk-xxxxxxxxxx")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI('https://api.mixroute.ai/v1/models')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'

response = http.request(request)
puts response.body

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1715232000,
      "owned_by": "openai"
    },
    {
      "id": "claude-opus-4-8",
      "object": "model",
      "created": 1743465600,
      "owned_by": "anthropic"
    }
  ]
}

GET

models

curl --request GET \
  --url https://api.mixroute.ai/v1/models \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxx",
    base_url="https://api.mixroute.ai/v1"
)

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

const response = await fetch('https://api.mixroute.ai/v1/models', {
  headers: {
    'Authorization': 'Bearer sk-xxxxxxxxxx'
  }
});
const data = await response.json();
console.log(data.data);

<?php
$client = new GuzzleHttp\Client();
$response = $client->get('https://api.mixroute.ai/v1/models', [
    'headers' => [
        'Authorization' => 'Bearer sk-xxxxxxxxxx'
    ]
]);
echo $response->getBody();

package main

import (
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.mixroute.ai/v1/models", nil)
    req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
    http.DefaultClient.Do(req)
}

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mixroute.ai/v1/models"))
    .header("Authorization", "Bearer sk-xxxxxxxxxx")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI('https://api.mixroute.ai/v1/models')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'

response = http.request(request)
puts response.body

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1715232000,
      "owned_by": "openai"
    },
    {
      "id": "claude-opus-4-8",
      "object": "model",
      "created": 1743465600,
      "owned_by": "anthropic"
    }
  ]
}

Introduction

Get the list of currently available models. This interface supports automatic format detection, no manual specification needed.

Automatic Format Detection

Automatically returns the corresponding format based on request headers: Anthropic, Gemini, or OpenAI format.

Authentication

Bearer Token, e.g., Bearer sk-xxxxxxxxxx

Request Headers

Response format is automatically detected based on request headers:

string

Returns Anthropic format response

string

Returns Gemini format response

Default returns OpenAI format response

Code Examples

cURL
Python
Node.js

curl https://api.mixroute.ai/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxx",
    base_url="https://api.mixroute.ai/v1"
)

models = client.models.list()

for model in models.data:
    print(f"Model ID: {model.id}, Provider: {model.owned_by}")

const axios = require('axios');

const response = await axios.get('https://api.mixroute.ai/v1/models', {
  headers: {
    'Authorization': 'Bearer sk-xxxxxxxxxx'
  }
});

console.log(response.data.data);

Response Fields

Field	Type	Description
object	string	Fixed as `list`
data	array	Model list
data[].id	string	Model unique identifier
data[].object	string	Fixed as `model`
data[].created	integer	Model creation timestamp (Unix timestamp)
data[].owned_by	string	Model provider (e.g., openai, anthropic, google)

Response Example

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1715232000,
      "owned_by": "openai"
    },
    {
      "id": "claude-opus-4-8",
      "object": "model",
      "created": 1743465600,
      "owned_by": "anthropic"
    },
    {
      "id": "gemini-3.5-flash",
      "object": "model",
      "created": 1746057600,
      "owned_by": "google"
    }
  ]
}

HTTP Status Codes

Status Code	Description
200	Request successful
401	API Key invalid or expired
429	Request rate too high
500	Server internal error

Error Response Example

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Notes

Recommend caching the model list to avoid frequent requests (recommend caching for 1 hour)
The returned model list dynamically changes based on your API Key permissions
Can call this interface at application startup for availability check
The created timestamps of different models may vary significantly, representing model release time only
Python example requires openai library: pip install openai
Node.js example requires axios library: npm install axios

curl --request GET \
  --url https://api.mixroute.ai/v1/models \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxx",
    base_url="https://api.mixroute.ai/v1"
)

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

const response = await fetch('https://api.mixroute.ai/v1/models', {
  headers: {
    'Authorization': 'Bearer sk-xxxxxxxxxx'
  }
});
const data = await response.json();
console.log(data.data);

<?php
$client = new GuzzleHttp\Client();
$response = $client->get('https://api.mixroute.ai/v1/models', [
    'headers' => [
        'Authorization' => 'Bearer sk-xxxxxxxxxx'
    ]
]);
echo $response->getBody();

package main

import (
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.mixroute.ai/v1/models", nil)
    req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
    http.DefaultClient.Do(req)
}

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mixroute.ai/v1/models"))
    .header("Authorization", "Bearer sk-xxxxxxxxxx")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI('https://api.mixroute.ai/v1/models')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'

response = http.request(request)
puts response.body

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1715232000,
      "owned_by": "openai"
    },
    {
      "id": "claude-opus-4-8",
      "object": "model",
      "created": 1743465600,
      "owned_by": "anthropic"
    }
  ]
}

Download Video

Popular Models

Smart Routing

OpenAI SDK Usage

Text Series

Embedding Series

Image Series

Video Series

Others

Introduction

Automatic Format Detection

Authentication

Request Headers

Code Examples

Response Fields

Response Example

HTTP Status Codes

Error Response Example

Notes

​Introduction

​Automatic Format Detection

​Authentication

​Request Headers

​Code Examples

​Response Fields

​Response Example

​HTTP Status Codes

​Error Response Example

​Notes

Introduction

Automatic Format Detection

Authentication

Request Headers

Code Examples

Response Fields

Response Example

HTTP Status Codes

Error Response Example

Notes