API de gestion des modèles

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>"
}

Nouvelle version de l’API

Obtenir les informations sur les modèles

Endpoint : GET https://aihubmix.com/api/v1/models Description : récupère les informations détaillées de tous les modèles disponibles.

Description des champs de l’objet modèle

Informations de base

array

Tableau d’objets d’information sur les modèles.

string

Identifiant unique du modèle, c’est-à-dire la valeur du paramètre model à utiliser lors des appels d’API.

string

Nom d’affichage du modèle.

integer

Numéro du développeur du modèle au sein de la plateforme, utilisable avec le paramètre de requête developer_id pour le filtrage.

string

Description des fonctionnalités du modèle (en anglais).

string

Identifiant du fournisseur de modèles (par exemple openai, anthropic, zhipu). Numérotation indépendante de developer_id. Champ optionnel : absent si l’information n’est pas répertoriée.

string

Type de modèle, valeurs séparées par des virgules. Valeurs prises en charge : llm (grand modèle de langage), image_generation (génération d’images), video (génération de vidéos), tts (synthèse vocale), stt (reconnaissance vocale), embedding (modèle d’embedding), rerank (modèle de reclassement), ocr (reconnaissance de texte), search (modèle de recherche), 3d (génération 3D).

string

Fonctionnalités prises en charge, valeurs séparées par des virgules. Valeurs prises en charge : thinking (raisonnement), tools (utilisation d’outils), function_calling (appel de fonctions), web (recherche web), deepsearch (recherche approfondie), long_context (contexte long), structured_outputs (sorties structurées).

string

Modalités d’entrée prises en charge, valeurs séparées par des virgules. Valeurs prises en charge : text (texte), image (image), audio (audio), video (vidéo), pdf.

string

Modalités de sortie prises en charge, valeurs séparées par des virgules. Valeurs prises en charge : text (texte), image (image), audio (audio), video (vidéo). Champ optionnel : absent si l’information n’est pas renseignée.

string

Protocoles d’API disponibles pour le modèle, valeurs séparées par des virgules. Valeurs prises en charge : chat_completions (API Chat Completions), responses (API Responses), claude_api (API Claude Messages), gemini_api (API Gemini). Une valeur vide signifie que l’information n’est pas encore renseignée.

integer

Nombre maximal de jetons de sortie.

integer

Taille de la fenêtre de contexte (nombre maximal de jetons d’entrée).

string

Date de publication du modèle, au format YYYY-MM-DD ou YYYY-MM. Champ optionnel : absent si l’information n’est pas répertoriée.

string

Date de la dernière mise à jour du modèle ; identique à release_date en l’absence de mise à niveau sur place enregistrée. Champ optionnel.

boolean

Indique si les poids du modèle sont ouverts au téléchargement et déployables par vos soins. false signifie que le fournisseur de modèles a explicitement annoncé ne pas publier les poids. Champ optionnel : absent si l’information n’est pas répertoriée.

boolean

Indique si la plateforme a terminé la vérification de la structure des paramètres de requête de ce modèle.

Tarification

object

Objet contenant les informations tarifaires. Tous les prix sont exprimés en dollars US par million (1M) de jetons.

number

Prix des jetons d’entrée (USD / 1M jetons).

number

Prix des jetons de sortie (USD / 1M jetons).

number

Prix de lecture du cache (USD / 1M jetons, champ optionnel).

number

Prix d’écriture du cache (USD / 1M jetons, champ optionnel).

array

Tableau des paliers de prix, champ optionnel. Chaque élément contient un objet tier (type fixé à context, size correspondant au seuil de jetons de contexte) ainsi que les prix input, output, cache_read, cache_write de ce palier. Lorsque la longueur de contexte de la requête dépasse size, la facturation applique les prix de ce palier ; les champs de premier niveau input, output, etc. correspondent au palier par défaut.

Capacités de raisonnement et d’outils

boolean

Indique si le modèle dispose de capacités de raisonnement ; valeur booléenne normalisée à partir de features. Champ optionnel : absent si l’information n’est pas renseignée, et cette absence n’implique pas une absence de prise en charge.

boolean

Indique si le modèle prend en charge l’utilisation d’outils ; valeur booléenne normalisée à partir de features. Champ optionnel : absent si l’information n’est pas renseignée, et cette absence n’implique pas une absence de prise en charge.

array

Tableau de configurations des niveaux de raisonnement, champ optionnel. Chaque élément contient type. Valeurs prises en charge : toggle (raisonnement activable et désactivable), effort (contrôle par niveau, values listant les niveaux disponibles et default le niveau par défaut), budget_tokens (contrôle par budget de jetons).

object

Support de restitution du contenu de raisonnement selon chaque protocole d’API, champ optionnel : absent si l’information n’est pas répertoriée. Les clés sont les noms de protocole (anthropic.messages, openai.chat_completions, openai.responses, google.gemini) ; la valeur est true (le protocole peut renvoyer le contenu de raisonnement) ou {"field": "reasoning_content"} (le contenu de raisonnement est renvoyé via ce champ). Consultez la clé correspondant au protocole réellement utilisé.

Variantes et cycle de vie

string

ID du modèle parent, champ optionnel. Sa présence indique que le model_id actuel et le modèle parent sont le même modèle ; seuls le palier ou le préréglage au sein de la plateforme diffèrent.

string

Type de variante, présent conjointement avec variant_of. Valeurs prises en charge : pricing-tier (palier de prix), channel-tier (palier d’accès), mode-preset (préréglage de mode), deprecated-alias (alias déprécié).

string

Étape du cycle de vie du modèle, toujours renvoyée. Valeurs prises en charge : active (service assuré normalement), deprecated (retrait annoncé, appels encore possibles). Les modèles dont le service est arrêté n’apparaissent pas dans la réponse de cet endpoint.

string

Date d’annonce du retrait (format ISO 8601). Renvoyé uniquement à l’étape deprecated.

string

Date prévue d’arrêt du service (format ISO 8601). Champ optionnel, susceptible d’être renvoyé uniquement à l’étape deprecated.

string

ID du modèle de remplacement recommandé pour la migration. Champ optionnel, susceptible d’être renvoyé uniquement à l’étape deprecated.

Promotions limitées

object

Informations sur une promotion à durée limitée, champ optionnel : absent en l’absence de promotion.

string

Nom de la promotion.

integer

Pourcentage de remise ; par exemple 10 correspond à une remise de 10 %.

string

Type de règle temporelle de la promotion. Valeurs prises en charge : absolute (intervalle de temps absolu, voir start et end de l’objet absolute), daily (plages horaires quotidiennes fixes, voir daily.ranges), weekly (plages hebdomadaires fixes, voir weekdays et ranges du tableau weekly ; weekdays suit la numérotation ISO 8601, lundi = 1, dimanche = 7).

Exemples de requêtes

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"

Description des paramètres de requête (pour le filtrage)

string

Type de modèle. Valeurs prises en charge : llm (grand modèle de langage), image_generation (génération d’images), video (génération de vidéos), tts (synthèse vocale), stt (reconnaissance vocale), embedding (modèle d’embedding), rerank (modèle de reclassement), ocr (reconnaissance de texte), search (modèle de recherche), 3d (génération 3D).

string

Modalités d’entrée. Valeurs prises en charge : text (texte), image (image), audio (audio), video (vidéo), pdf. Prend en charge les requêtes multimodalités (valeurs séparées par des virgules).

string

Recherche approximative par nom de modèle (correspondance partielle prise en charge).

string

Fonctionnalités du modèle. Valeurs prises en charge : thinking (raisonnement), tools (utilisation d’outils), function_calling (appel de fonctions), web (recherche web), deepsearch (recherche approfondie), long_context (contexte long), structured_outputs (sorties structurées). Prend en charge les requêtes multifonctionnalités (valeurs séparées par des virgules).

string

Filtrage par protocole d’API. Valeurs prises en charge : chat_completions, responses, claude_api, gemini_api. Prend en charge les requêtes multivaleurs (valeurs séparées par des virgules).

integer

Filtrage par numéro de développeur du modèle ; le numéro figure dans le champ de réponse developer_id.

string

Filtrage par étiquette de modèle, par exemple coding (modèles de programmation).

boolean

Avec la valeur true, renvoie uniquement les modèles dont la plateforme a terminé la vérification de la structure des paramètres de requête (c’est-à-dire les modèles dont le champ de réponse schema_checked vaut true).

string

Champ de tri. Valeurs prises en charge :
• model_ratio : tri par rapport coût/efficacité
• context_length : tri par longueur de contexte
• coding : priorité aux modèles de programmation
• order : tri par ordre par défaut

string

Ordre de tri. Valeurs prises en charge :
• asc (ascendant)
• desc (descendant)

Exemple de réponse en cas de succès

{
    "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
}

Exemples de scénarios d’utilisation

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

Remarque : lors de l’utilisation du tri intelligent des modèles de programmation, le système affiche en priorité les modèles portant l’étiquette coding, les autres modèles étant rangés dans l’ordre par défaut.

Optimisation des performances

Mécanisme de mise en cache

Politique de cache : mise en cache HTTP, durée du cache de 300 secondes (5 minutes).
Contrôle du cache : Cache-Control: private, max-age=300, stale-while-revalidate=300
Validation du contenu : prise en charge de la validation par hash de contenu ETag.

Exemple d’utilisation du cache

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

Si le contenu n’a pas été mis à jour, le serveur renvoie un code d’état 304 Not Modified.

Gestion des erreurs

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

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

Remarques importantes

Intégrité des données : cet endpoint renvoie tous les modèles correspondant aux critères, sans pagination.
Compatibilité des types : prend en charge le mappage automatique entre les anciens et nouveaux identifiants de type :
- t2t ↔ llm
- t2i ↔ image_generation
- t2v ↔ video
- reranking ↔ rerank
Logique de filtrage : plusieurs conditions de filtre sont combinées avec un ET logique.
Règle de tri : si aucune méthode de tri n’est spécifiée, les modèles sont rangés dans l’ordre par défaut du système.
Cycle de vie : les modèles dont retire_stage vaut deprecated restent appelables normalement ; il est recommandé de planifier la migration à l’avance en consultant les champs successor_model et retired_at. Les modèles dont le service est arrêté n’apparaissent pas dans la liste renvoyée.
Champs optionnels : l’absence d’un champ marqué comme optionnel signifie que l’information n’est pas renseignée ou pas répertoriée ; cette absence n’implique pas que le modèle ne dispose pas de la capacité correspondante.

Version héritée de l’API

⚠️ Remarque : les endpoints suivants sont des endpoints d’API hérités. Il est recommandé d’utiliser la nouvelle version de l’API pour de meilleures performances et fonctionnalités.

Obtenir la liste des modèles

Endpoint : GET /v1/models

Si un utilisateur est connecté, cette opération récupère la liste des modèles disponibles pour le groupe de l’utilisateur. Si aucun utilisateur n’est connecté, elle récupère la liste pour le groupe default.
Si l’en-tête contient un champ Authorization, elle interroge la liste des modèles configurés pour le token correspondant.

Exemple de réponse :

{
  "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
    }
  ]
}

Réponse

Code d’état	Signification	Description	Modèle de données
200	OK	aucun	Inline

Structure des données de réponse

Code d’état 200

Nom	Type	Requis	Description
» data	[object]	oui	aucun
»» id	string	oui	ID du modèle
»» object	string	oui	`model`
»» created	integer	oui	Horodatage de création
»» owned_by	string	oui	Développeur
»» permission	[object]¦null	oui	aucun
»»» id	string	oui	aucun
»»» object	string	oui	aucun
»»» created	integer	oui	aucun
»»» allow_create_engine	boolean	oui	aucun
»»» allow_sampling	boolean	oui	aucun
»»» allow_logprobs	boolean	oui	aucun
»»» allow_search_indices	boolean	oui	aucun
»»» allow_view	boolean	oui	aucun
»»» allow_fine_tuning	boolean	oui	aucun
»»» organization	string	oui	aucun
»»» group	null	oui	aucun
»»» is_blocking	boolean	oui	aucun
»» root	string	oui	Nom du modèle racine
»» parent	null	oui	Modèle parent

Obtenir les informations sur un modèle

Endpoint : GET /v1/models/:model

Paramètres de requête

Nom	Dans	Type	Requis	Description
model	path	string	oui	ID du modèle

Exemple de réponse :

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
}

Réponse

Code d’état	Signification	Description	Modèle de données
200	OK	aucun	Inline

Structure des données de réponse

Code d’état 200

Nom	Type	Requis	Description
id	string	oui	ID du modèle
object	string	oui	`model`
created	integer	oui	Horodatage de création
owned_by	string	oui	Développeur
permission	[object]	oui	aucun
» id	string	non	aucun
» object	string	non	aucun
» created	integer	non	aucun
» allow_create_engine	boolean	non	aucun
» allow_sampling	boolean	non	aucun
» allow_logprobs	boolean	non	aucun
» allow_search_indices	boolean	non	aucun
» allow_view	boolean	non	aucun
» allow_fine_tuning	boolean	non	aucun
» organization	string	non	aucun
» group	null	non	aucun
» is_blocking	boolean	non	aucun
root	string	oui	Nom du modèle racine
parent	null	oui	Modèle parent

Dernière mise à jour : 2026-09-18

⌘I

API de gestion des modèles

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>"
}

Endpoints de modèle

API plateforme

API de gestion des modèles

Nouvelle version de l’API

Obtenir les informations sur les modèles

Description des champs de l’objet modèle

Informations de base

Tarification

Capacités de raisonnement et d’outils

Variantes et cycle de vie

Promotions limitées

Exemples de requêtes

Description des paramètres de requête (pour le filtrage)

Exemple de réponse en cas de succès

Exemples de scénarios d’utilisation

Optimisation des performances

Mécanisme de mise en cache

Exemple d’utilisation du cache

Gestion des erreurs

Remarques importantes

Version héritée de l’API

Obtenir la liste des modèles

Réponse

Structure des données de réponse

Obtenir les informations sur un modèle

Paramètres de requête

Réponse

Structure des données de réponse

​Nouvelle version de l’API

​Obtenir les informations sur les modèles

​Description des champs de l’objet modèle

​Informations de base

​Tarification

​Capacités de raisonnement et d’outils

​Variantes et cycle de vie

​Promotions limitées

​Exemples de requêtes

​Description des paramètres de requête (pour le filtrage)

​Exemple de réponse en cas de succès

​Exemples de scénarios d’utilisation

​Optimisation des performances

​Mécanisme de mise en cache

​Exemple d’utilisation du cache

​Gestion des erreurs

​Remarques importantes

​Version héritée de l’API

​Obtenir la liste des modèles

​Réponse

​Structure des données de réponse

​Obtenir les informations sur un modèle

​Paramètres de requête

​Réponse

​Structure des données de réponse

Nouvelle version de l’API

Obtenir les informations sur les modèles

Description des champs de l’objet modèle

Informations de base

Tarification

Capacités de raisonnement et d’outils

Variantes et cycle de vie

Promotions limitées

Exemples de requêtes

Description des paramètres de requête (pour le filtrage)

Exemple de réponse en cas de succès

Exemples de scénarios d’utilisation

Optimisation des performances

Mécanisme de mise en cache

Exemple d’utilisation du cache

Gestion des erreurs

Remarques importantes

Version héritée de l’API

Obtenir la liste des modèles

Réponse

Structure des données de réponse

Obtenir les informations sur un modèle

Paramètres de requête

Réponse

Structure des données de réponse