Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Ajoutez un fallback de modèle en conservant une petite liste ordonnée de model ID dans votre application et en essayant le modèle suivant uniquement lorsque l’échec est réessayable ou spécifique au modèle. Ne réessayez pas les requêtes mal formées ; corrigez les erreurs 400, 401 et les erreurs de requête invalide avant d’appeler un autre modèle.

Implémenter un fallback ordonné

L’exemple Python suivant essaie les model ID dans l’ordre et s’arrête sur les erreurs non réessayables :
import os
import time
from openai import OpenAI, APIError, RateLimitError

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

models = ["your-primary-model-id", "your-fallback-model-id"]

for model in models:
    try:
        completion = client.chat.completions.create(
            model=model,
            messages=[
                {
                    "role": "user",
                    "content": "Summarize CometAPI in one sentence.",
                }
            ],
        )
        print(completion.choices[0].message.content)
        break
    except RateLimitError:
        time.sleep(2)
        continue
    except APIError as error:
        status_code = getattr(error, "status_code", None)
        if status_code in {500, 503, 504, 524}:
            time.sleep(2)
            continue
        raise
else:
    raise RuntimeError("All configured model fallbacks failed.")
La réponse réussie provient du premier modèle qui se termine :
{
  "model": "your-fallback-model-id",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "CometAPI gives developers one API surface for multiple model providers."
      }
    }
  ]
}

Choisir des modèles de fallback

La requête suivante liste les model ID disponibles que vous pouvez évaluer pour le fallback :
curl https://api.cometapi.com/api/models
La réponse contient des enregistrements de modèle :
{
  "success": true,
  "page": 0,
  "page_size": 0,
  "total": 301,
  "data": [
    {
      "id": "deepseek-v4-pro",
      "provider": "DeepSeek",
      "model_type": "text",
      "features": [
        "text-to-text"
      ],
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 0.416,
        "output": 0.832,
        "per_request": null,
        "per_second": null
      },
      "api_doc_url": "https://apidoc.cometapi.com/api/text/chat"
    }
  ]
}

Erreurs courantes

ErreurCorrection
Le fallback masque les requêtes invalidesN’utilisez pas le fallback sur les erreurs 400, 401 ou de requête invalide.
Les modèles ont des formats de sortie différentsNormalisez la réponse dans votre application avant de la renvoyer aux utilisateurs.
Le fallback augmente le coûtEstimez le coût de chaque modèle avant de l’ajouter à la liste de fallback.
Trop de fallbacks parallèlesEssayez les fallbacks séquentiellement, sauf si votre produit exige une exécution parallèle.

Liens associés

Last modified on May 28, 2026