에러

상태 코드와 대응 방법.

코드	type	뜻과 대응
401	authentication_error	키가 없거나 폐기됐어요. 헤더를 확인해주세요.
402	insufficient_credit	크레딧이 모자라요. 충전하거나 max_tokens 를 줄여주세요.
404	model_not_found	그 모델은 없어요. 응답에 가까운 모델을 함께 알려드려요.
400	invalid_request_error	요청 형식 문제예요. 벤더 문서의 요청 규격을 따라주세요.
503	upstream_unavailable	모든 경로가 실패했어요. 잠시 후 다시 시도해주세요.

402 는 호출 전에 나요

게이트웨이는 부르기 전에 이 요청이 최대로 쓸 금액을 미리 잡아둬요. 잔액이 그보다 적으면 벤더로 보내지 않고 402 를 돌려줘요. 그래서 max_tokens 를 크게 잡으면 잔액이 남아 있어도 막힐 수 있어요 — 줄이면 통과해요.

429 나 5xx 가 나면 같은 모델을 다른 경로로 다시 시도해요. 몇 번째에 성공했는지는 응답 헤더 x-gateway-fallback-depth 에 담겨요. 400 이나 404 처럼 다시 보내도 같을 실패는 재시도하지 않고 그대로 돌려드려요.