Obtenir la liste des modèles

Récupère tous les modèles actuellement disponibles sur la plateforme, regroupés sur deux niveaux : capacité du modèle et fournisseur du modèle. Une fois le modelId obtenu, vous pouvez le référencer dans les autres interfaces nécessitant de spécifier un modèle.

Cette interface est limitée à 60 requêtes/minute par compte. La liste des modèles de la plateforme change rarement ; il est recommandé de mettre le résultat en cache côté appelant.

Méthode de requête

GET

URL de la requête

https://api-${endpoint}.gptbots.ai/v1/model/list

Authentification de la requête

Cette interface utilise le DevKey / DevSecret au niveau du compte, transmis via l'authentification HTTP Basic :

                      
                      Authorization: Basic base64(${DevKey}:${DevSecret})

                    

Concaténez DevKey et DevSecret avec deux-points, encodez l'ensemble en Base64 et préfixez-le de Basic (attention à l'espace).

Pour obtenir le DevKey / DevSecret : connectez-vous à la console et accédez à Centre personnel - Compte - Informations développeur, où vous trouverez l'identifiant développeur (DevKey) et l'API DevSecret.

⚠️ À ne pas confondre avec l'authentification au niveau de l'Agent : les interfaces telles que les API de conversation utilisent l'API Key de l'Agent (Authorization: Bearer ${API Key}), tandis que cette interface utilise le DevKey / DevSecret du compte avec l'authentification Basic. Les deux ne sont pas interchangeables.

Base64 est un encodage réversible, pas un chiffrement. Traitez la chaîne encodée comme un mot de passe en clair : ne la soumettez pas dans un dépôt de code et ne l'écrivez pas dans des documents publics.

Requête

Exemple de requête

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/model/list' \
-H 'Authorization: Basic ${base64(DevKey:DevSecret)}'

                    

En-têtes de la requête

Paramètres de la requête

Aucun.

Réponse

Exemple de réponse

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "CHAT": {
      "OPEN_AI": [
        { "aiModelVersion": "gpt-4o", "modelId": "65f2c1a8d3b4e5f601234567" },
        { "aiModelVersion": "gpt-3.5-turbo", "modelId": "65f2c1a8d3b4e5f601234568" }
      ],
      "ANTHROPIC_CLAUDE": [
        { "aiModelVersion": "claude-opus-4-8", "modelId": "65f2c1a8d3b4e5f601234569" }
      ]
    },
    "EMBEDDING": {
      "OPEN_AI_EMB": [
        { "aiModelVersion": "text-embedding-3-large", "modelId": "65f2c1a8d3b4e5f60123456a" }
      ]
    },
    "RERANK": { },
    "SPEECH2TEXT": { },
    "TEXT2SPEECH": { },
    "MODERATION": { },
    "ANONYMIZATION": { }
  }
}

                    

Réponse en cas de succès

Structure à deux niveaux de data

                      
                      data
 └── capacité du modèle       clé externe, 7 types, ordre fixe
      └── fournisseur du modèle  clé interne, p. ex. OPEN_AI
           └── [ liste des modèles ]

                    

Les clés externes sont les capacités des modèles, fixées aux 7 types suivants et toujours renvoyées dans cet ordre :

Les clés internes sont les identifiants des fournisseurs. En prenant CHAT comme exemple, les valeurs possibles incluent OPEN_AI, AZURE, ANTHROPIC_CLAUDE, GEMINI, ALI_QWEN, DEEP_SEEK, KIMI, META_LLAMA, MISTRAL, ZHIPU_CHATGLM, HUNYUAN, ERINE, XAI_GROK, BYTEDANCE_SEED, SENSE, etc. Les identifiants diffèrent sous les autres capacités (p. ex. OPEN_AI_EMB, JINA_EMB sous EMBEDDING).

• Si une capacité n'a actuellement aucun modèle disponible, sa valeur est un objet vide {}. La clé apparaît quand même et n'est jamais omise ; vérifiez qu'elle n'est pas vide avant d'itérer.
• La plateforme peut ajouter ou retirer des fournisseurs. Fiez-vous à la réponse réelle de l'interface et ne codez pas la liste des fournisseurs en dur.
• Les fournisseurs et les modèles sont triés selon la priorité d'affichage configurée sur la plateforme. L'ordre n'est qu'indicatif pour l'affichage — ne construisez pas de logique métier dessus (p. ex. « le premier est le modèle par défaut »).

Réponse en cas d'échec

Codes d'erreur