API publiqueModels

Models

Liste les identifiants de modèles que votre clé peut utiliser. Chaque identifiant est un alias stable : 3gk-llm (chat completions), 3gk-embed (embeddings) et 3gk-rerank (reranking).

stablev1compatible OpenAI

Endpoint#endpoint

GEThttps://ai.3gks.cloud/v1/modelsauth : Bearer sk-3gk-…

GET /v1/models/{id} est également disponible (client.models.retrieve(…) des SDK OpenAI) et renvoie l'entrée correspondante ou 404.

Format de réponse#response

Réponse au format OpenAI : un objet list contenant un tableau de modèles. Chaque entrée déclare un id utilisable dans le paramètre model de l'endpoint correspondant (chat/completions, embeddings, rerank).

application/json
{
  "object": "list",
  "data": [
    {
      "id": "3gk-llm",
      "object": "model",
      "created": 1715761712,
      "owned_by": "3gk-software"
    },
    {
      "id": "3gk-embed",
      "object": "model",
      "created": 1715761712,
      "owned_by": "3gk-software"
    },
    {
      "id": "3gk-rerank",
      "object": "model",
      "created": 1715761712,
      "owned_by": "3gk-software"
    }
  ]
}

Exemple#exemple

curl
curl https://ai.3gks.cloud/v1/models \
  -H "Authorization: Bearer sk-3gk-7XQp4kL8…"

Alias stables#alias-stables

Les identifiants 3gk-* sont découplés du modèle sous-jacent : lorsque nous faisons évoluer un modèle (montée de version, changement de famille), l'alias ne change pas et votre intégration continue de fonctionner à l'identique. Écrivez toujours votre code contre ces alias.

Rétrocompatibilité. L'ancien alias default et les anciens identifiants de modèles restent acceptés en entrée pendant une période de transition, mais les réponses renvoient toujours l'alias canonique (3gk-llm, 3gk-embed ou 3gk-rerank). Migrez vos intégrations vers les alias 3gk-*.
200 OK
Succès · Liste des modèles disponibles pour votre clé.
401
auth_error · Clé manquante, invalide ou révoquée.