Vai al contenuto principale

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.

Aggiungi il fallback dei modelli mantenendo nella tua app un piccolo elenco ordinato di model ID e provando il modello successivo solo quando l’errore è ritentabile o specifico del modello. Non ritentare richieste non valide; correggi gli errori 400, 401 e di richiesta non valida prima di chiamare un altro modello.

Implementa un fallback ordinato

L’esempio Python seguente prova i model ID in ordine e si ferma sugli errori non ritentabili:
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 risposta riuscita proviene dal primo modello che completa l’operazione:
{
  "model": "your-fallback-model-id",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "CometAPI gives developers one API surface for multiple model providers."
      }
    }
  ]
}

Scegli i modelli di fallback

La richiesta seguente elenca i model ID disponibili che puoi valutare per il fallback:
curl https://api.cometapi.com/api/models
La risposta contiene record di modello:
{
  "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"
    }
  ]
}

Errori comuni

ErroreCorrezione
Il fallback nasconde richieste non valideNon eseguire il fallback su errori 400, 401 o di richiesta non valida.
I modelli hanno formati di output diversiNormalizza la risposta nella tua app prima di restituirla agli utenti.
Il fallback aumenta il costoStima il costo per ogni modello prima di aggiungerlo all’elenco di fallback.
Troppi fallback paralleliProva i fallback in sequenza a meno che il tuo prodotto non richieda una competizione parallela.
Last modified on May 28, 2026