Adicionar fallback de modelo com CometAPI

Adicione fallback de modelo mantendo uma pequena lista ordenada de model IDs no seu app e tentando o próximo modelo apenas quando a falha permitir retry ou for específica do modelo. Não repita requisições malformadas; corrija erros 400, 401 e de requisição inválida antes de chamar outro modelo.

Implementar fallback ordenado

O exemplo em Python a seguir tenta model IDs em ordem e para em erros que não permitem retry:

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.")

A resposta bem-sucedida vem do primeiro modelo que conclui:

{
  "model": "your-fallback-model-id",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "CometAPI gives developers one API surface for multiple model providers."
      }
    }
  ]
}

Escolher modelos de fallback

A requisição a seguir lista os model IDs disponíveis que você pode avaliar para fallback:

curl https://api.cometapi.com/api/models

A resposta contém registros de modelos:

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

Erros comuns

Erro	Correção
O fallback oculta requisições inválidas	Não use fallback em erros `400`, `401` ou de requisição inválida.
Os modelos têm formatos de saída diferentes	Normalize a resposta no seu app antes de retorná-la aos usuários.
O fallback aumenta o custo	Estime o custo de cada modelo antes de adicioná-lo à lista de fallback.
Muitos fallbacks paralelos	Tente os fallbacks sequencialmente, a menos que seu produto exija disputa paralela.

Comece aqui

Guias rápidos da API de modelos

Guias principais da API

Bibliotecas

Erros

Preços e faturamento

Suporte

Adicionar fallback de modelo com CometAPI

Implementar fallback ordenado

Escolher modelos de fallback

Erros comuns

Links relacionados

​Implementar fallback ordenado

​Escolher modelos de fallback

​Erros comuns

​Links relacionados

Implementar fallback ordenado

Escolher modelos de fallback

Erros comuns

Links relacionados