Obtener lista de modelos

Obtiene todos los modelos disponibles actualmente en la plataforma, agrupados en dos niveles: capacidad del modelo y proveedor del modelo. Con el modelId obtenido, puede referenciar el modelo en otras interfaces que requieran especificar uno.

Esta interfaz tiene un límite de 60 solicitudes/minuto por cuenta. La lista de modelos de la plataforma cambia con poca frecuencia; se recomienda almacenar en caché el resultado en el lado del llamador.

Método de solicitud

GET

URL de solicitud

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

Autenticación de la solicitud

Esta interfaz utiliza DevKey / DevSecret a nivel de cuenta, transmitidos mediante autenticación básica HTTP:

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

                    

Concatene DevKey y DevSecret con dos puntos, codifique toda la cadena en Base64 y anteponga Basic (tenga en cuenta el espacio).

Para obtener DevKey / DevSecret: inicie sesión en la consola y vaya a Centro personal - Cuenta - Información del desarrollador, donde encontrará el Identificador de desarrollador (DevKey) y el API DevSecret.

⚠️ No confundir con la autenticación a nivel de Agent: interfaces como las de conversación utilizan la API Key del Agent (Authorization: Bearer ${API Key}), mientras que esta interfaz usa el DevKey / DevSecret de la cuenta con autenticación Basic. Ambas no son intercambiables.

Base64 es una codificación reversible, no un cifrado. Trate la cadena codificada como una contraseña en texto plano: no la suba a repositorios de código ni la incluya en documentos públicos.

Solicitud

Ejemplo de solicitud

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

                    

Cabeceras de la solicitud

Parámetros de la solicitud

Ninguno.

Respuesta

Ejemplo de respuesta

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

                    

Respuesta de éxito

Estructura de dos niveles de data

                      
                      data
 └── capacidad del modelo     clave externa, 7 tipos, orden fijo
      └── proveedor del modelo  clave interna, p. ej. OPEN_AI
           └── [ lista de modelos ]

                    

Las claves externas son las capacidades del modelo, fijadas en los siguientes 7 tipos y devueltas siempre en este orden:

Las claves internas son identificadores de proveedores. Tomando CHAT como ejemplo, los valores posibles incluyen OPEN_AI, AZURE, ANTHROPIC_CLAUDE, GEMINI, ALI_QWEN, DEEP_SEEK, KIMI, META_LLAMA, MISTRAL, ZHIPU_CHATGLM, HUNYUAN, ERINE, XAI_GROK, BYTEDANCE_SEED, SENSE, entre otros. Los identificadores difieren en otras capacidades (p. ej. OPEN_AI_EMB, JINA_EMB bajo EMBEDDING).

• Si una capacidad no tiene modelos disponibles actualmente, su valor es un objeto vacío {}. La clave sigue apareciendo y nunca se omite; compruebe si está vacía antes de iterar.
• La plataforma puede añadir o retirar proveedores. Base su lógica en la respuesta real de la interfaz y no codifique la lista de proveedores de forma fija.
• Los proveedores y modelos se ordenan según la prioridad de visualización configurada en la plataforma. El orden es solo de referencia visual: no construya lógica de negocio sobre él (p. ej. «el primero es el modelo por defecto»).

Respuesta de error

Códigos de error