List Models

curl "https://api.aisonar.dev/v1/models" \
  -H "Authorization: Bearer sk-your-api-key"

curl "https://api.aisonar.dev/v1/models?recommended_for=image" \
  -H "Authorization: Bearer sk-your-api-key"

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.aisonar.dev/v1"
)

models = client.models.list()

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

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://api.aisonar.dev/v1'
});

const models = await client.models.list();

for (const model of models.data) {
  console.log(`${model.id} (${model.owned_by})`);
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.aisonar.dev/v1/models", nil)
    req.Header.Set("Authorization", "Bearer sk-your-api-key")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    var payload struct {
        Data []struct {
            ID      string `json:"id"`
            OwnedBy string `json:"owned_by"`
        } `json:"data"`
    }

    json.NewDecoder(resp.Body).Decode(&payload)

    for _, model := range payload.Data {
        fmt.Printf("%s (%s)\n", model.ID, model.OwnedBy)
    }
}

<?php
$ch = curl_init('https://api.aisonar.dev/v1/models');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk-your-api-key'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
foreach ($data['data'] as $model) {
    echo "{$model['id']} ({$model['owned_by']})\n";
}

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.4",
      "object": "model",
      "created": 1706000000,
      "owned_by": "openai"
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "created": 1706000000,
      "owned_by": "anthropic"
    },
    {
      "id": "gemini-3.5-flash",
      "object": "model",
      "created": 1706000000,
      "owned_by": "google"
    }
  ]
}

Response

string

Always list.

array

Array of model objects.Each model always contains:

id (string): Model identifier
object (string): model
created (integer): Creation timestamp
owned_by (string): Model provider
aisonar.aliases (array): Public aliases for the same model
aisonar.pricing (object): Scalar public pricing summary
aisonar.capabilities (array): Public capability tags
aisonar.max_input_tokens (number or null): Input context limit when available
aisonar.max_output_tokens (number or null): Output limit when available
aisonar.category (string): Public model category
aisonar.pricing_unit (string): Public pricing unit
aisonar.has_complex_pricing (boolean): Whether model pricing has model-specific dimensions
aisonar.lifecycle (object): Lifecycle stage, release/deprecation dates, replacement model, and latest badge derivation
aisonar.commercial (object): User charge policy, free reason, and optional free-until timestamp
aisonar.badges (array): Display badges derived from lifecycle and commercial metadata

Conditional list metadata:

aisonar.providers (array): Public providers when available
aisonar.cache_pricing (object or null): Prompt-cache prices when available
aisonar.pricing_summary (object or null): Returned only for complex-pricing models
aisonar.request_format_summary (object or null): Lightweight non-chat discovery summary with public_operations, request_endpoint, and request_endpoint_by_operation
aisonar.agent_preferences (object): Returned only when recommended_for is present

Detail-only fields such as aisonar.capability_flags, aisonar.supported_operations, aisonar.pricing_provenance, and aisonar.request_format_details are only returned by GET /v1/models/{model}.

GET /v1/models is optimized for discovery. Detail-only metadata such as capability_flags, pricing_provenance, and the full request_format_details live on GET /v1/models/{model}.

Model Deletion

DELETE /v1/models/{model} is not supported. AI Sonar models are a shared public catalog, not user-owned fine-tuned model resources.

Query Parameters

string

Optional public category filter. Supports chat, image, video, audio, tts, stt, music, 3d, embedding, rerank, and translation.

string

Optional non-chat recommendation scene. Supports image, video, music, 3d, tts, stt, embedding, rerank, and translation.

string

Optional provider filter such as openai, anthropic, google, or deepseek.

string

Optional model tag filter such as chat, image, video, embedding, or translation.

When recommended_for is present, /v1/models sorts non-chat models by the latest cached 24-hour success-rate snapshot. Models with status = "insufficient_samples" remain visible but sort after scored models.

curl "https://api.aisonar.dev/v1/models" \
  -H "Authorization: Bearer sk-your-api-key"

curl "https://api.aisonar.dev/v1/models?recommended_for=image" \
  -H "Authorization: Bearer sk-your-api-key"

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.aisonar.dev/v1"
)

models = client.models.list()

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

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://api.aisonar.dev/v1'
});

const models = await client.models.list();

for (const model of models.data) {
  console.log(`${model.id} (${model.owned_by})`);
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.aisonar.dev/v1/models", nil)
    req.Header.Set("Authorization", "Bearer sk-your-api-key")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    var payload struct {
        Data []struct {
            ID      string `json:"id"`
            OwnedBy string `json:"owned_by"`
        } `json:"data"`
    }

    json.NewDecoder(resp.Body).Decode(&payload)

    for _, model := range payload.Data {
        fmt.Printf("%s (%s)\n", model.ID, model.OwnedBy)
    }
}

<?php
$ch = curl_init('https://api.aisonar.dev/v1/models');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk-your-api-key'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
foreach ($data['data'] as $model) {
    echo "{$model['id']} ({$model['owned_by']})\n";
}

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.4",
      "object": "model",
      "created": 1706000000,
      "owned_by": "openai"
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "created": 1706000000,
      "owned_by": "anthropic"
    },
    {
      "id": "gemini-3.5-flash",
      "object": "model",
      "created": 1706000000,
      "owned_by": "google"
    }
  ]
}

Filtering by Provider

# Get all OpenAI models
openai_models = [m for m in models.data if m.owned_by == "openai"]

# Get all Anthropic models
anthropic_models = [m for m in models.data if m.owned_by == "anthropic"]

Model Categories

Provider	Example Models
`openai`	gpt-5.4, gpt-5.4-mini, gpt-5-mini, gpt-4o, gpt-image-2
`anthropic`	claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5
`google`	gemini-3.1-pro-preview, gemini-3.5-flash, gemini-2.5-pro
`deepseek`	deepseek-r1, deepseek-v3-2
`xai`	grok-4.1
`moonshot`	kimi-k2.5
`minimax`	minimax-m3
`meta`	llama-3.3-70b, llama-3.1-405b

Agent Recommendation Example

Response

{
  "object": "list",
  "data": [
    {
      "id": "gemini-2.5-flash-image",
      "object": "model",
      "created": 1706000000,
      "owned_by": "google",
      "aisonar": {
        "category": "image",
        "pricing_unit": "per_request",
        "agent_preferences": {
          "image": {
            "preferred_rank": 1,
            "success_rate_24h": 0.98,
            "sample_count_24h": 423,
            "status": "ready",
            "updated_at": "2026-03-28T12:00:00.000Z",
            "basis": {
              "source": "recent_activity_24h"
            }
          }
        }
      }
    }
  ]
}

Core

Text

Files & Batches

Images

Audio & Realtime

Music

Video & Materials

Worlds

3D

Async Jobs

Gemini Native

Response

Model Deletion

Query Parameters

Filtering by Provider

Model Categories

Agent Recommendation Example

​Response

​Model Deletion

​Query Parameters

​Filtering by Provider

​Model Categories

​Agent Recommendation Example

Response

Model Deletion

Query Parameters

Filtering by Provider

Model Categories

Agent Recommendation Example