이 사이트가 반환하는 모든 실패를 2026-09-01에 실제 엔드포인트로 한 건씩 호출해 확인한 목록입니다. 반환되는 8건 중 5건은 상태 코드가 실제 원인을 가리키지 않으며, 그중 2건은 공식 SDK가 조용히 재시도하기 때문에 프로그램에 도달하는 시점이 더 늦어집니다.
2026-09-01 검증
상태 코드가 실제 원인과 다름
모델 이름을 잘못 쓰면 503, messages 필드를 빼먹으면 500이 돌아옵니다. 둘 다 요청 자체의 잘못이라 몇 번을 재시도해도 결과가 바뀌지 않습니다. 그런데 openai-python, openai-node, Anthropic SDK는 모두 408·409·429와 모든 5xx를 기본값으로 두 번, 지수 백오프까지 붙여 재시도합니다. 오타 하나가 세 번의 왕복과 수십 초의 대기로 바뀌고, 그다음에야 처음부터 정해져 있던 원인이 드러납니다. 진짜 원인은 처음부터 응답 본문의 error.code에 있고, 거짓말을 하는 쪽은 상태 코드입니다.
대조표
숫자 순서가 아니라 실제로 자주 만나는 순서로 정렬했습니다.
빈 문자열Invalid tokenmodel_not_found상태 코드가 실제 원인과 다름No available channel for model gpt-4o under group y-api (distributor)insufficient_user_quota상태 코드가 실제 원인과 다름用户额度不足, 剩余额度: ＄0.00pre_consume_token_quota_failed상태 코드가 실제 원인과 다름token quota is not enough, token remain quota: ＄0.000002, need quota: ＄0.000074invalid_request상태 코드가 실제 원인과 다름field messages is requiredinvalid_request_error상태 코드가 실제 원인과 다름`messages` is required and must be a non-empty array.빈 문자열Invalid request: Invalid request: invalid JSON request body빈 문자열Invalid URL (POST /v1/messages/count_tokens)조용한 실패
200을 반환하고 예외도 던지지 않아 프로그램이 그대로 진행되는 실패가 세 가지 있습니다. 잘못된 것은 내용이거나 청구액입니다. 그래서 스스로 발견하기가 어렵습니다.
상류는 5개 모델에 image_ratio를 붙여 두었습니다. 그것은 과금 계수이지 시각 능력이 아닙니다. 다섯 모델 모두 data URL 이미지를 받아 200을 반환하고, 본 적 없는 그림에 대해 자신 있게 답합니다 — 프로브가 보낸 것은 순수한 초록색 PNG였지만 색을 맞힌 모델은 하나도 없었습니다. 추천 모델은 오히려 400으로 거부하는데, 두 실패 중에서는 그쪽이 안전합니다.
클라이언트 호환성 매트릭스 출처
상한을 12로 두었는데 moonshotai/kimi-k2.5의 과금은 261, 21.8배였습니다. 잘라내기 자체는 작동합니다(finish_reason=length). 초과분은 추론 토큰이며, 과금은 되지만 content에는 나타나지 않습니다. 이 상한으로 계산한 비용 추정치는 같은 배수만큼 낮게 나옵니다.
클라이언트 호환성 매트릭스 출처
POST /v1/messages는 접두사 없는 16진수 id를 반환합니다. msg_ 접두사를 전제로 검증하거나 id를 파싱해 응답을 분기하는 코드는 일치하지 않습니다 — 본문의 나머지는 규격에 맞는데도 그렇습니다.
클라이언트 호환성 매트릭스 출처
파싱
겉은 항상 {"error": {...}}이지만 필드 구성은 일정하지 않습니다. param이 있는 오류와 없는 오류가 있고, code는 빈 문자열인 경우가 많습니다. 모든 필드를 선택 항목으로 다루세요.
{"error":{"code":"","message":"Invalid token (request id: 2026090114474514374…)","type":"new_api_error"}}{"error":{"message":"Invalid URL (POST /v1/messages/count_tokens)","type":"invalid_request_error","param":"","code":""}}모든 메시지 끝에는 request id가 붙고 요청마다 다릅니다. 이 페이지와 대조하기 전에 떼어내세요. 반대로 문제를 제보할 때는 반드시 함께 보내 주세요 — 로그에서 그 요청을 특정할 수 있는 유일한 단서입니다.
원인 추적
이 순서대로. 한 단계마다 한 층을 배제하므로, 멈추는 지점이 답입니다.
GET /v1/models는 크레딧을 쓰지 않고 같은 키를 사용합니다. 200과 모델 목록이 오면 키·네트워크·CDN 엣지 모두 문제가 없다는 뜻입니다. 즉 원인은 인증이 아니라 요청 본문에 있습니다.
curl -s https://api.y-api.bestvirtualgoods.com/v1/models -H "Authorization: Bearer $YAPI_KEY" | head -c 200이렇게 하면 SDK를 떼어낼 수 있습니다. curl은 성공하는데 내 코드가 실패하면, 차이는 그 라이브러리가 요청을 만드는 방식에 있고 이 사이트에 있는 것이 아닙니다.
curl -i https://api.y-api.bestvirtualgoods.com/v1/chat/completions \
-H "Authorization: Bearer $YAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek/deepseek-v4-flash","messages":[{"role":"user","content":"hi"}]}'재시도를 끄면 내 요청 때문에 생긴 500이나 503이 첫 시도에서 바로 드러납니다. 쓸데없는 두 번의 대기가 끼지 않습니다. 끝나면 되돌리세요 — 진짜 일시적 장애에는 재시도가 의미가 있습니다.
client = OpenAI(
base_url="https://api.y-api.bestvirtualgoods.com/v1",
api_key=os.environ["YAPI_KEY"],
max_retries=0, # 진단 중에만
)상태 페이지에서 이 사이트 자체가 저하 상태인지 지난 90일 기록과 함께 확인할 수 있습니다. 그쪽이 초록인데도 막혀 있다면, 오류 본문의 request id를 보내 주시는 것이 가장 도움이 됩니다.