Қысқа жауап: әрбір сәтсіз сұрау үшін Claude-тан GPT-ке ауыспаңыз. 401 аутентификацияны түзету керегін, ал жолға қатысты 404 URL немесе endpoint-ті түзету керегін білдіреді. 429 немесе уақытша 5xx кері шегінумен қайтадан жіберілуі мүмкін; егер шектелген қайта әрекеттер де сәтсіз болса, үйлесімді балама модель басқаруды өз мойнына ала алады.
Бір маңызды ерекшелік бар: error.code: invalid_request бар 500 жауабы бәрібір сұрау мәселесі. Оны қайта жіберу — немесе сол сынған payload-ты басқа модельге жіберу — ақауды тек жасырған болады.
Бұл мақала 2026 жылғы 20 тамызда CometAPI-дің қате, қайта әрекет, base URL, жылдамдық шектеуі және модельдік балама құжаттарына қарсы тексерілді. Бұл тек қателерді жіктеуді қамтиды. Бағытты жобалау, провайдер тіркелгі деректері және көпқабатты failover үшін толық модельдік балама оқулығын және техникалық балама нұсқаулығын пайдаланыңыз.
Қайта әрекет ету не тоқтау шешімінен бастаңыз
| Мәртебе | Әдетте нені білдіреді | Қайта әрекет? | Балама? | Бірінші әрекет |
|---|---|---|---|---|
| 401 | Жоқ немесе қате кілт | Жоқ | Жоқ | Bearer токенін түзету |
| 404 | Қате жол немесе endpoint | Жоқ | Жоқ | Base URL мен маршрутты тексеру |
| 429 | Жылдамдық шектеуі немесе қанығу | Иә | Шектелген әрекеттерден кейін | Джиттермен кері шегіну |
| 500 + invalid_request | Қате пішімделген сұрау | Жоқ | Жоқ | Payload-ты түзету |
| 500/503/504/524 | Уақытша платформа не провайдер ақауы | Иә | Шектелген әрекеттерден кейін | Сұрау ID-ін сақтау |
Практикалық сұрақ “Claude істен шықты ма?” емес. “Осы сұраудың қате бөлігі өзгермей-ақ басқа модель сәтті орындай ала ма?” Аутентификация және жол қателері қосылыстың өзіне әсер етеді, сондықтан модельді ауыстыру оларды шешпейді. Уақытша сыйымдылық пен сервер ақаулары маршрутқа тән болуы мүмкін, сондықтан балама көмектеседі.
Модельдерді ауыстырмас бұрын қатені оқыңыз
HTTP мәртебесін error.code және error.message-пен бірге пайдаланыңыз. Көптеген CometAPI ақаулары мынадай конвертті қолданады:
{
"error": {
"message": "human-readable detail and request id",
"type": "comet_api_error",
"param": "problematic_parameter_or_empty",
"code": "error_code_or_empty"
}
}
Мәртебе кодын тек алғашқы цифры бойынша жіктемеңіз. 500 әлі де invalid_request алып жүруі мүмкін, ал қате CometAPI жолы таза JSON 404 орнына қайта бағыттау немесе HTML қайтара алады.
401 Unauthorized: Аутентификацияны тоқтатып түзетіңіз
401 әдетте API кілті жоқ, бұрмаланған, мерзімі өткен немесе қате ортадан жүктелген дегенді білдіреді. Тақырып келесідей болуы тиіс:
Authorization: Bearer $COMETAPI_KEY
Қайтадан жібермеңіз және модельдерді ауыстырмаңыз. Екі маршрут та бірдей бұзылған аутентификацияны қолданады. Жүктелген қызметтің ескі құпияны оқыған-оқымағанын, кілтке бос орын қосылған-қосылмағанын және сұраудың көзделген ортаға жеткен-жетпегенін тексеріңіз. Кілтті тек құпияларды басқару үдерісі арқылы ауыстырыңыз немесе қайта жүктеңіз.
404 Not Found: Баламаға ауысудан бұрын URL-ді түзетіңіз
OpenAI-үйлесімді сұраулар үшін мына base URL-ді дәл қолданыңыз:
https://api.cometapi.com/v1
/v1 жоқтығы, қайталанған жол сегменті немесе қате endpoint 404, қайта бағыттау, HTML жауап немесе SDK талдау қатесін тудыруы мүмкін. Жөндеу кезінде автоматты қайта бағыттауды өшіріп, соңғы сұрау жолын API анықтамасымен салыстырыңыз.
Егер жауап нақты бір модель қолжетімсіз немесе табылмады десе, ағымдағы CometAPI Models API ішіндегі модель ID-ін тексеріңіз. Әрбір 404-ті модельдің қолжетімсіздігі ретінде қабылдамаңыз. Дәл сол сигналды түсіріп, тексергеннен кейін ғана модельге тән баламаны қосыңыз.
429 Too Many Requests: Failover алдында кері шегініңіз
429 қайта әрекет етуге жарамды. Экспоненциалды кері шегінуді джиттермен қолданыңыз, жарқ етпе параллелділікті азайтыңыз және қай маршруттың қанығып тұрғанын өлшеңіз. Әрбір жұмысшының бірден қайта жіберуі қысқа жылдамдық шектеуін үлкенірек трафик толқынына айналдыра алады.
Аз ғана, шектелген саннан кейін балама орынды, егер келесі модель бірдей кіріс, шығыс келісімшартын және қажетті мүмкіндіктерді қолдайтын болса. Балама тегін емес: ол кідіріс қосады және құн немесе мінез-құлықты өзгертуі мүмкін, сондықтан оның қолданылу жиілігін тіркеңіз.
5xx қателері: Кодты тексеріңіз, содан кейін қайта жіберіңіз
500, 503, 504 және 524 көбінесе платформа, провайдер немесе таймаут сыныптағы ақауларды білдіреді. Сұрау ID-ін, endpoint-ті, модельді және уақыт таңбасын сақтап, содан кейін кері шегінумен қайта жіберіңіз. Егер сол уақытша ақау қайта әрекеттер бюджетіне қарамастан сақталса, келесі үйлесімді маршрутқа көшіңіз.
Бірақ алдымен денесін тексеріңіз. 500 денесінде error.code: invalid_request немесе invalid_request_error болса, сұрау денесін түзетіңіз және тек өзгерткеннен кейін ғана қайта жіберіңіз. Жиі себептеріне messages өрісінің жоқтығы немесе таңдалған endpoint қабылдамайтын провайдерге тән параметр жатады.
Кодта бір шағын саясат қолданыңыз
Бұл Python мысалы қайта әрекеттер мен баламаны қолданбаның ішінде ұстайды. Ол бір CometAPI кілтін, OpenAI-үйлесімді base URL-ді және ағымдағы Claude және GPT модель ID-лері үшін орта айнымалыларын пайдаланады. Ол тек уақытша ақауларды қайта әрекет етеді, содан кейін қайта әрекеттер бюджеті таусылған соң модельді ауыстырады.
import os, random, time
from openai import APIError, OpenAI
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1",
max_retries=0,
)
MODELS = [os.environ["CLAUDE_MODEL"], os.environ["GPT_MODEL"]]
RETRYABLE = {429, 500, 503, 504, 524}
def complete(messages):
for model in MODELS:
for attempt in range(3):
try:
response = client.chat.completions.create(model=model, messages=messages)
return response.choices[0].message.content
except APIError as error:
status = getattr(error, "status_code", None)
code = getattr(error, "code", None)
if status in {401, 404} or code in {
"invalid_request", "invalid_request_error"
}:
raise
if status not in RETRYABLE:
raise
if attempt < 2:
time.sleep(2**attempt + random.random())
continue
break
raise RuntimeError("No configured route completed.")
print(complete([{"role": "user", "content": "Summarize this ticket."}]))
SDK-ның автоматты қайта әрекеттері өшірілген, сондықтан қолданба жалпы қайта әрекет және балама бюджетіне иелік етеді. Онсыз SDK қайта әрекеттері мен қолданбалық қайта әрекеттердің көбейтілген үйлесімі қоңыраулар санын арттырып, соңғы жауапты кешіктіре алады.
Саясатты болжамсыз сынаңыз
| Имитацияланған сигнал | Күтілетін нәтиже | Болмауы тиіс нәрсе |
|---|---|---|
| 401 | Дереу қате лақтыру | Қайта әрекет те, GPT қоңырауы да жоқ |
| 404 | Дереу қате лақтыру | Қате жолды жасырған балама жоқ |
| 429 | Кері шегіну, сосын балама | Бірден қайта жіберу дауылы жоқ |
| 500 + invalid_request | Дереу қате лақтыру | Сынған сұрауды қайталау жоқ |
| 503/504/524 | Кері шегіну, сосын балама | Шексіз маршрут тізбегі жоқ |
Бұлар — провайдердің нақты сенімділігі туралы емес, саясаттық тесттер. Staging-те мәртебе мен қате денесін жіктеушіге енгізіп, қоңыраулардың саны мен ретін тексеріңіз және соңғы қатеңізде бастапқы сұрау контексті қалатынын растаңыз.
Claude-тан GPT-ке баламаға ауысу қашан шынымен қауіпсіз
Модельдер арасында ауысу тек екі маршрут та бірдей қолданбалық келісімшартты орындай алғанда қауіпсіз. Сұрау және жауап өрістерін нормалаңыз, құрылымдалған шығару немесе құрал мінез-құлқын екі модельде де сынаңыз және қажет бейне, құжат, контекст немесе пайымдау мүмкіндігі қосулы екенін растаңыз.
Баламаны жанама әсерлерді ескере отырып орындаңыз. Егер бірінші маршрут қазірдің өзінде құралды шақырса, дерек жазса немесе ішінара жауапты ағынмен жіберсе, бүкіл сұрауды соқыр түрде қайталау әрекеттерді қайталауы немесе пайдаланушыны шатастыруы мүмкін. Бақылау нүктесінен жалғастырыңыз немесе басқарылатын сәтсіздік қайтарыңыз.
Қайта әрекеттерді шектеп тұратын өндірістік тексерулер
- Бір жалпы кідіріс бюджеті орнатыңыз. Әрбір қайта әрекет пен баламаны сол дедлайнға есептеңіз.
- Қайта әрекеттерді шектеңіз. Джиттермен кері шегінуді қолданыңыз және аз ғана конфигурацияланған шекте тоқтаңыз.
- Параллелділікті басқарыңыз. Сұраулар қолданбадан шықпай тұрып жарқ етпе жүктемелерді азайтыңыз.
- Circuit breaker қосыңыз. Қайта-қайта істен шығатын маршрутқа уақытша шақыруларды тоқтатыңыз.
- Шешімдерді журналға жазыңыз. Құпияларды сақтамай, мәртебені, қате кодын, сұрау ID-ін, модельді, әрекетті, кідірісті және балама себебін тіркеңіз.
- Балама жиілігін қадағалаңыз. Оның тұрақты өсуі қалыпты сәттілік емес, операциялық сигнал.
Жиі қойылатын сұрақтар
401 баламаны триггерлеуі керек пе?
Жоқ. API кілтін түзетіңіз немесе қайта жүктеңіз. Сол жарамсыз тіркелгі деректері арқылы шақырылатын басқа модель дәл сондай себеппен сәтсіз болады.
404 баламаны триггерлеуі керек пе?
Әдепкіде жоқ. Алдымен base URL немесе endpoint-ті түзетіңіз. Тек бөлек расталған модель-қолжетімсіз сигналы ғана балама жіктеуішіне кіруі тиіс.
429-ды қанша рет қайта жіберу керек?
Пайдаланушыға бағытталған кідіріс бюджетіне сай шағын қолданбалық шекті пайдаланыңыз. Джиттермен кері шегінуді қолданыңыз және параллелділікті азайтыңыз; бірден немесе шексіз қайта жібермеңіз.
Барлық 5xx қателері қайта жіберіле ме?
Жоқ. Уақытша 500, 503, 504 және 524 жауаптары қайта әрекетке үміткер, бірақ invalid_request бар 500 payload түзетілгенше қатаң түрде сәтсіз болуы тиіс.
Claude және GPT бірдей сұрауды өзгеріссіз қолдана ала ма?
Тек қолданбаңыз сынаған ортақ өрістер үшін. Провайдерге тән параметрлер, құрал форматтары, құрылымдалған шығару және мультимодаль кірістер адаптерлерді қажет етуі мүмкін. Тек модель ID-ін өзгерту үйлесімділікті дәлелдемейді.
Толық балама іске асыру қайда?
Кеңірек архитектура үшін How to Build Robust LLM Model Fallback Strategies, ал іске асырудың егжей-тегжейі үшін CometAPI model fallback guide қараңыз.
Қателерді жіктеушіні қақпа сақшысы етіңіз
Автоматты балама тар әрі бақыланатын болғанда пайдалы. Аутентификация, жол және қате пішімделген сұраулар қателерін айқын түрде сәтсіз аяқтаңыз. Жылдамдық шектеуі және уақытша сервер ақауларын кері шегінумен қайта әрекет етіңіз, содан кейін ғана қайта әрекеттер бюджеті таусылғанда үйлесімді маршрутқа көшіңіз. Мұндай саясат баламаны конфигурация ақауларын жасыру құралы емес, сенімділік бақылауына айналдырады.