Langsung ke konten utama

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.

Tambahkan model fallback dengan menyimpan daftar kecil model ID yang berurutan di aplikasi Anda dan mencoba model berikutnya hanya ketika kegagalan dapat di-retry atau spesifik pada model. Jangan mencoba ulang permintaan yang malformed; perbaiki error 400, 401, dan invalid request sebelum Anda memanggil model lain.

Menerapkan fallback berurutan

Contoh Python berikut mencoba model ID secara berurutan dan berhenti pada error yang tidak bisa di-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.")
Respons yang berhasil berasal dari model pertama yang selesai:
{
  "model": "your-fallback-model-id",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "CometAPI gives developers one API surface for multiple model providers."
      }
    }
  ]
}

Memilih model fallback

Permintaan berikut mencantumkan model ID yang tersedia yang dapat Anda evaluasi untuk fallback:
curl https://api.cometapi.com/api/models
Respons berisi record model:
{
  "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"
    }
  ]
}

Error umum

KesalahanPerbaikan
Fallback menyembunyikan permintaan yang tidak validJangan lakukan fallback pada error 400, 401, atau invalid request.
Model memiliki format output yang berbedaNormalisasi respons di aplikasi Anda sebelum mengembalikannya ke pengguna.
Fallback meningkatkan biayaPerkirakan biaya untuk setiap model sebelum menambahkannya ke daftar fallback.
Terlalu banyak fallback paralelCoba fallback secara berurutan kecuali produk Anda memerlukan race paralel.

Tautan terkait

Last modified on May 28, 2026