Model Management API

GET

api

models

curl --request GET \
  --url https://aihubmix.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {}
  ],
  "model_id": "<string>",
  "model_name": "<string>",
  "developer_id": 123,
  "desc": "<string>",
  "vendor": "<string>",
  "types": "<string>",
  "features": "<string>",
  "input_modalities": "<string>",
  "output_modalities": "<string>",
  "endpoints": "<string>",
  "max_output": 123,
  "context_length": 123,
  "release_date": "<string>",
  "last_updated": "<string>",
  "open_weights": true,
  "schema_checked": true,
  "pricing": {},
  "pricing.input": 123,
  "pricing.output": 123,
  "pricing.cache_read": 123,
  "pricing.cache_write": 123,
  "pricing.tiers": [
    {}
  ],
  "reasoning": true,
  "tool_call": true,
  "reasoning_options": [
    {}
  ],
  "interleaved": {},
  "variant_of": "<string>",
  "variant_kind": "<string>",
  "retire_stage": "<string>",
  "deprecated_at": "<string>",
  "retired_at": "<string>",
  "successor_model": "<string>",
  "promotion": {},
  "promotion.name": "<string>",
  "promotion.off_percent": 123,
  "promotion.time_type": "<string>"
}

New API Version

Get Model Information

Endpoint: GET https://aihubmix.com/api/v1/models Description: Fetches detailed information for all available models.

Model Object Field Descriptions

Basic information

array

An array of model information objects

string

The unique identifier for the model, which is the value used for the model parameter when calling the API

string

The display name of the model

integer

The platform-internal ID of the model developer, usable with the developer_id request parameter for filtering

string

A description of the model’s functionality (in English)

string

Model vendor identifier (such as openai, anthropic, zhipu). This is a separate numbering system from developer_id. Optional field; when absent, the value has not been recorded

string

Model type, comma-separated. Supported values: llm (large language model), image_generation (image generation model), video (video generation model), tts (text-to-speech model), stt (speech-to-text model), embedding (embedding model), rerank (reranking model), ocr (text recognition model), search (search model), 3d (3D generation model)

string

Supported features, comma-separated. Supported values: thinking (supports reasoning), tools (supports tool use), function_calling (supports function calling), web (supports search), deepsearch (supports deep search), long_context (long-context model), structured_outputs (structured outputs)

string

Supported input modalities, comma-separated. Supported values: text, image, audio, video, pdf

string

Supported output modalities, comma-separated. Supported values: text, image, audio, video. Optional field; when absent, the value has not been annotated

string

API protocols available for the model, comma-separated. Supported values: chat_completions (Chat Completions API), responses (Responses API), claude_api (Claude Messages API), gemini_api (Gemini API). An empty value means the field has not been annotated yet

integer

Maximum number of output tokens

integer

Context window size (maximum number of input tokens)

string

Model release date, in YYYY-MM-DD or YYYY-MM format. Optional field; when absent, the value has not been recorded

string

Date of the model’s most recent update. When there is no in-place upgrade record, it equals release_date. Optional field

boolean

Whether the model weights are openly downloadable and self-deployable. false means the vendor has explicitly stated the weights will not be released. Optional field; when absent, the value has not been recorded

boolean

Whether the platform has completed verification of the model’s request parameter schema

Pricing

object

Pricing information object. All prices are in USD per 1 million (1M) tokens

number

Input token price (USD / 1M tokens)

number

Output token price (USD / 1M tokens)

number

Cache read price (USD / 1M tokens, optional field)

number

Cache write price (USD / 1M tokens, optional field)

array

Tiered pricing array, optional field. Each element contains a tier object (type is always context, size is the context token count threshold) plus the input, output, cache_read, and cache_write prices for that tier. When the request’s context length exceeds size, billing follows that tier’s prices; the top-level input, output, and related fields are the default tier prices

Reasoning and tool capabilities

boolean

Whether the model has reasoning capability, a boolean normalized from features. Optional field; when absent, the value has not been annotated, and absence does not mean the capability is unsupported

boolean

Whether the model supports tool use, a boolean normalized from features. Optional field; when absent, the value has not been annotated, and absence does not mean the capability is unsupported

array

Reasoning level configuration array, optional field. Each item contains type. Supported values: toggle (reasoning can be switched on and off), effort (controlled by level, with values listing the available levels and default giving the default level), budget_tokens (controlled by token budget)

object

Where reasoning content is returned under each API protocol. Optional field; when absent, the value has not been recorded. Keys are protocol names (anthropic.messages, openai.chat_completions, openai.responses, google.gemini); values are true (the protocol can return reasoning content) or {"field": "reasoning_content"} (reasoning content is returned via that field). Read the key that matches the protocol you actually call

Variants and lifecycle

string

Parent model ID, optional field. When present, the current model_id and the parent model are the same model, differing only in platform-side tier or preset

string

Variant type, appearing together with variant_of. Supported values: pricing-tier (pricing tier), channel-tier (access tier), mode-preset (mode preset), deprecated-alias (deprecated alias)

string

Model lifecycle stage, always returned. Supported values: active (in normal service), deprecated (retirement announced, still callable). Models whose service has ended do not appear in this endpoint’s response

string

Time of the retirement announcement (ISO 8601 format). Returned only in the deprecated stage

string

Planned end-of-service time (ISO 8601 format). Optional field; may be returned only in the deprecated stage

string

Recommended replacement model ID for migration. Optional field; may be returned only in the deprecated stage

Limited-time promotions

object

Limited-time promotion information, optional field. Absent when there is no promotion

string

Name of the promotion

integer

Discount percentage. For example, 10 means 10% off

string

Promotion time rule type. Supported values: absolute (an absolute time range, see the absolute object’s start and end), daily (fixed time windows each day, see daily.ranges), weekly (fixed time windows each week, see the weekly array’s weekdays and ranges; weekdays uses ISO 8601 numbering, with Monday as 1 and Sunday as 7)

Request Examples

import requests

# API endpoint
url = "https://aihubmix.com/api/v1/models"

response = requests.get(url)
print(response.json())

params = {
    "type": "llm",                   
	"modalities": "text",
	"model": "gpt-5",
	"features": "thinking",
    "sort_by": "context_length",
    "sort_order": "desc"    
}
response = requests.get(url, params=params)
print(response.json())

fetch('https://aihubmix.com/api/v1/models')
  .then(response => response.json())
  .then(data => console.log(data));

const params = new URLSearchParams({
  type: 'llm',
  modalities: 'text',
  model: 'gpt-5',
  features: 'thinking',
  sort_by: 'context_length',
  sort_order: 'desc' 
});

fetch(`https://aihubmix.com/api/v1/models?${params}`)
  .then(response => response.json())
  .then(data => console.log(data));

curl -X GET "https://aihubmix.com/api/v1/models"

curl -X GET "https://aihubmix.com/api/v1/models?type=llm&modalities=text&model=gpt-5&features=thinking&sort_by=context_length&sort_order=desc"

Request Parameter Descriptions (for Filtering)

string

Model type. Supported values: llm (large language model), image_generation (image generation model), video (video generation model), tts (text-to-speech model), stt (speech-to-text model), embedding (embedding model), rerank (reranking model), ocr (text recognition model), search (search model), 3d (3D generation model)

string

Input modalities. Supported values: text, image, audio, video, pdf. Supports multi-modality queries (comma-separated)

string

Fuzzy search for model name (supports partial matching)

string

Model features. Supported values: thinking (supports reasoning), tools (supports tool use), function_calling (supports function calling), web (supports search), deepsearch (supports deep search), long_context (long-context model), structured_outputs (structured outputs). Supports multi-feature queries (comma-separated)

string

Filter by API protocol. Supported values: chat_completions, responses, claude_api, gemini_api. Supports multi-value queries (comma-separated)

integer

Filter by model developer ID. IDs are given in the developer_id response field

string

Filter by model tag, such as coding (coding models)

boolean

When set to true, returns only models for which the platform has completed request parameter schema verification (models whose schema_checked response field is true)

string

Sort by field. Supported values:
• model_ratio: sort by cost-effectiveness
• context_length: sort by context length
• coding: prioritize coding models
• order: sort by default order

string

Sort order. Supported values:
• asc (ascending)
• desc (descending)

Successful Response Example

{
    "data": [
        {
            "model_id": "gpt-6-astra",
            "model_name": "GPT 6 Astra",
            "developer_id": 12,
            "desc": "GPT-6 Astra is OpenAI's newest and most intelligent model, with industry-leading performance in computer operations, web browsing, software engineering, scientific research, and professional work.",
            "pricing": {
                "cache_read": 1,
                "cache_write": 12.5,
                "input": 10,
                "output": 50,
                "tiers": [
                    {
                        "cache_read": 2,
                        "cache_write": 25,
                        "input": 20,
                        "output": 75,
                        "tier": {
                            "size": 272000,
                            "type": "context"
                        }
                    }
                ]
            },
            "types": "llm",
            "features": "tools,thinking,structured_outputs",
            "input_modalities": "text,image",
            "endpoints": "chat_completions,responses",
            "max_output": 128000,
            "context_length": 1050000,
            "release_date": "2026-09-05",
            "last_updated": "2026-09-05",
            "output_modalities": "text",
            "reasoning": true,
            "tool_call": true,
            "reasoning_options": [
                {
                    "type": "effort",
                    "values": ["low", "medium", "high", "xhigh", "max"],
                    "default": "medium"
                }
            ],
            "interleaved": {
                "openai.responses": true
            },
            "vendor": "openai",
            "open_weights": false,
            "schema_checked": false,
            "retire_stage": "active"
        },
        {
            "model_id": "glm-5.3",
            "model_name": "GLM 5.3",
            "developer_id": 5,
            "desc": "GLM-5.3 is Z.AI's coding and agentic reasoning model, built for complex software engineering, long-running agent tasks, vulnerability analysis, and other demanding workloads.",
            "pricing": {
                "cache_read": 0.2817,
                "input": 1.1268,
                "output": 3.9438
            },
            "types": "llm",
            "features": "thinking,tools,function_calling,structured_outputs",
            "input_modalities": "text",
            "endpoints": "",
            "max_output": 131072,
            "context_length": 1048576,
            "release_date": "2026-08-14",
            "last_updated": "2026-08-14",
            "output_modalities": "text",
            "reasoning": true,
            "tool_call": true,
            "reasoning_options": [
                {
                    "type": "toggle"
                },
                {
                    "type": "effort",
                    "values": ["low", "high", "max"],
                    "default": "max"
                }
            ],
            "interleaved": {
                "anthropic.messages": true,
                "openai.chat_completions": {
                    "field": "reasoning_content"
                }
            },
            "vendor": "zhipu",
            "open_weights": true,
            "schema_checked": false,
            "promotion": {
                "name": "GLM-5.3 limited-time special offer",
                "off_percent": 10,
                "time_type": "daily",
                "daily": {
                    "ranges": ["00:00-23:59"]
                }
            },
            "retire_stage": "active"
        }
    ],
    "message": "",
    "success": true
}

Usage Scenario Examples

GET https://aihubmix.com/api/v1/models?type=llm

GET https://aihubmix.com/api/v1/models?tag=coding&sort_by=context_length&sort_order=desc

GET https://aihubmix.com/api/v1/models?model=gpt-5

GET https://aihubmix.com/api/v1/models?type=llm&modalities=text,image&features=function_calling&sort_by=model_ratio&sort_order=asc

GET https://aihubmix.com/api/v1/models?sort_by=coding

GET https://aihubmix.com/api/v1/models?endpoints=claude_api

GET https://aihubmix.com/api/v1/models?schema_checked=true

Note: When using smart sort for coding models, the system will prioritize models tagged with coding, and other models will be listed in the default order.

Performance Optimization

Caching Mechanism

Cache Policy: HTTP caching, cache duration 300 seconds (5 minutes)
Cache Control: Cache-Control: private, max-age=300, stale-while-revalidate=300
Content Validation: Supports ETag content hash validation

Cache Usage Example

# Conditional request using ETag
curl -H "If-None-Match: \"abc123...\"" \
     https://aihubmix.com/api/v1/models

If the content has not been updated, the server returns a 304 Not Modified status code.

Error Handling

{
  "success": false,
  "message": "Invalid request parameter format"
}

{
  "success": false,
  "message": "Internal server error, please try again later"
}

Important Notes

Data integrity: This endpoint returns all models that meet the criteria, without pagination
Type compatibility: Supports automatic mapping between new and old type identifiers
- t2t ↔ llm
- t2i ↔ image_generation
- t2v ↔ video
- reranking ↔ rerank
Filtering logic: Multiple filter conditions are combined with a logical AND
Sorting rule: When no sorting method is specified, models are arranged in the system’s default order
Lifecycle: Models with retire_stage set to deprecated can still be called normally. Refer to the successor_model and retired_at fields to plan migration ahead of time; models whose service has ended do not appear in the returned list
Optional fields: When a field marked as optional is absent, the information has not been annotated or recorded. Absence does not mean the model lacks the corresponding capability

Legacy API Version

⚠️ Note: The following are legacy API endpoints. It is recommended to use the new API version for better performance and features.

Get Model List

Endpoint: GET /v1/models

If a user is logged in, it retrieves the list of available models for the user’s group. If no user is logged in, it retrieves the list for the default group.
If the header contains an Authorization field, it queries the list of models configured for the corresponding token.

Response Example:

{
  "data": [
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "created": 1626777600,
      "owned_by": "OpenAI",
      "permission": [
        {
          "id": "modelperm-LwHkVFn8AcMItP432fKKDIKJ",
          "object": "model_permission",
          "created": 1626777600,
          "allow_create_engine": true,
          "allow_sampling": true,
          "allow_logprobs": true,
          "allow_search_indices": false,
          "allow_view": true,
          "allow_fine_tuning": false,
          "organization": "*",
          "group": null,
          "is_blocking": false
        }
      ],
      "root": "gpt-4o-mini",
      "parent": null
    }
  ]
}

Response

Status Code	Meaning	Description	Data Model
200	OK	none	Inline

Response Data Structure

Status Code 200

Name	Type	Required	Description
» data	[object]	true	none
»» id	string	true	Model ID
»» object	string	true	`model`
»» created	integer	true	Timestamp of creation
»» owned_by	string	true	Developer
»» permission	[object]¦null	true	none
»»» id	string	true	none
»»» object	string	true	none
»»» created	integer	true	none
»»» allow_create_engine	boolean	true	none
»»» allow_sampling	boolean	true	none
»»» allow_logprobs	boolean	true	none
»»» allow_search_indices	boolean	true	none
»»» allow_view	boolean	true	none
»»» allow_fine_tuning	boolean	true	none
»»» organization	string	true	none
»»» group	null	true	none
»»» is_blocking	boolean	true	none
»» root	string	true	Root model name
»» parent	null	true	Parent model

Get Model Information

Endpoint: GET /v1/models/:model

Request Parameters

Name	In	Type	Required	Description
model	path	string	true	Model ID

Response Example:

200 Response

{
  "id": "string",
  "object": "string",
  "created": 0,
  "owned_by": "string",
  "permission": [
    {
      "id": "string",
      "object": "string",
      "created": 0,
      "allow_create_engine": true,
      "allow_sampling": true,
      "allow_logprobs": true,
      "allow_search_indices": true,
      "allow_view": true,
      "allow_fine_tuning": true,
      "organization": "string",
      "group": null,
      "is_blocking": true
    }
  ],
  "root": "string",
  "parent": null
}

Response

Status Code	Meaning	Description	Data Model
200	OK	none	Inline

Response Data Structure

Status Code 200

Name	Type	Required	Description
id	string	true	Model ID
object	string	true	`model`
created	integer	true	Timestamp of creation
owned_by	string	true	Developer
permission	[object]	true	none
» id	string	false	none
» object	string	false	none
» created	integer	false	none
» allow_create_engine	boolean	false	none
» allow_sampling	boolean	false	none
» allow_logprobs	boolean	false	none
» allow_search_indices	boolean	false	none
» allow_view	boolean	false	none
» allow_fine_tuning	boolean	false	none
» organization	string	false	none
» group	null	false	none
» is_blocking	boolean	false	none
root	string	true	Root model name
parent	null	true	Parent model

Last updated: 2026-09-18

Model Management API

curl --request GET \
  --url https://aihubmix.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {}
  ],
  "model_id": "<string>",
  "model_name": "<string>",
  "developer_id": 123,
  "desc": "<string>",
  "vendor": "<string>",
  "types": "<string>",
  "features": "<string>",
  "input_modalities": "<string>",
  "output_modalities": "<string>",
  "endpoints": "<string>",
  "max_output": 123,
  "context_length": 123,
  "release_date": "<string>",
  "last_updated": "<string>",
  "open_weights": true,
  "schema_checked": true,
  "pricing": {},
  "pricing.input": 123,
  "pricing.output": 123,
  "pricing.cache_read": 123,
  "pricing.cache_write": 123,
  "pricing.tiers": [
    {}
  ],
  "reasoning": true,
  "tool_call": true,
  "reasoning_options": [
    {}
  ],
  "interleaved": {},
  "variant_of": "<string>",
  "variant_kind": "<string>",
  "retire_stage": "<string>",
  "deprecated_at": "<string>",
  "retired_at": "<string>",
  "successor_model": "<string>",
  "promotion": {},
  "promotion.name": "<string>",
  "promotion.off_percent": 123,
  "promotion.time_type": "<string>"
}

Model Endpoints

Platform API

Model Management API

New API Version

Get Model Information

Model Object Field Descriptions

Basic information

Pricing

Reasoning and tool capabilities

Variants and lifecycle

Limited-time promotions

Request Examples

Request Parameter Descriptions (for Filtering)

Successful Response Example

Usage Scenario Examples

Performance Optimization

Caching Mechanism

Cache Usage Example

Error Handling

Important Notes

Legacy API Version

Get Model List

Response

Response Data Structure

Get Model Information

Request Parameters

Response

Response Data Structure

​New API Version

​Get Model Information

​Model Object Field Descriptions

​Basic information

​Pricing

​Reasoning and tool capabilities

​Variants and lifecycle

​Limited-time promotions

​Request Examples

​Request Parameter Descriptions (for Filtering)

​Successful Response Example

​Usage Scenario Examples

​Performance Optimization

​Caching Mechanism

​Cache Usage Example

​Error Handling

​Important Notes

​Legacy API Version

​Get Model List

​Response

​Response Data Structure

​Get Model Information

​Request Parameters

​Response

​Response Data Structure

New API Version

Get Model Information

Model Object Field Descriptions

Basic information

Pricing

Reasoning and tool capabilities

Variants and lifecycle

Limited-time promotions

Request Examples

Request Parameter Descriptions (for Filtering)

Successful Response Example

Usage Scenario Examples

Performance Optimization

Caching Mechanism

Cache Usage Example

Error Handling

Important Notes

Legacy API Version

Get Model List

Response

Response Data Structure

Get Model Information

Request Parameters

Response

Response Data Structure