Aiberm logo
로그인

오류 처리

Aiberm API 요청이 실패하면 API는 JSON 오류 객체를 반환합니다. HTTP 상태 코드, error.code, error.message를 사용해 문제를 파악하고 다음 조치를 결정하세요.

지원이 필요하면 모든 request id가 포함된 전체 오류 응답을 함께 보내 주세요.

오류 응답 형식

{
  "error": {
    "message": "用户额度不足, 剩余额度: ¥0.00 (request id: 20260622xxxxxxxx)",
    "type": "new_api_error",
    "code": "insufficient_user_quota"
  }
}
필드의미
message사람이 읽을 수 있는 오류 메시지입니다. 끝의 (request id: ...)는 이 요청의 추적 ID입니다. 지원에 문의할 때 포함하세요.
code오류 범주 식별자입니다. 아래의 일반적인 오류와 맞춰 보세요.
type오류 출처 표시입니다. 대부분의 경우 직접 처리할 필요는 없습니다.

message에 (request id: ...) 값이 여러 개 있으면 정상입니다. 요청이 여러 서비스 계층을 거쳤다는 뜻입니다. 지원에 문의할 때 전체 오류 메시지를 복사하세요.

HTTP 상태 코드

상태의미조치
400잘못된 요청 형식요청 JSON, 필수 필드, Content-Type, 모델 이름을 확인하세요.
401잘못된 API 키API 키가 올바른지, 만료·비활성화되었는지, 할당량이 소진되었는지 확인하세요.
403권한 없음 또는 잔액 부족계정 잔액, 토큰 권한, 모델 권한, 출발 IP를 확인하세요.
404리소스를 찾을 수 없음엔드포인트 URL과 모델 이름 철자를 확인하세요.
429요청이 너무 많음동시성 또는 요청 빈도를 낮춘 뒤 나중에 다시 시도하세요.
500내부 서버 오류나중에 다시 시도하세요. 계속되면 request id와 함께 지원에 문의하세요.
503일시적으로 서비스를 사용할 수 없음현재 모델에 사용 가능한 경로가 없습니다. 나중에 다시 시도하거나 지원에 문의하세요.

API 키 및 인증 오류

이러한 오류는 보통 401을 반환합니다.

표시될 수 있는 메시지일반적인 원인해결 방법
无效的令牌API 키가 잘못되었거나 존재하지 않습니다.키가 완전하고 문자가 빠지거나 더해지지 않았는지 확인하세요. 콘솔에서 다시 복사하세요.
该令牌已过期토큰이 만료되었습니다.콘솔에서 토큰을 다시 발급하거나 유효 기간을 연장하세요.
该令牌额度已用尽이 토큰에 할당된 할당량이 소진되었습니다.토큰 할당량을 늘리거나 할당량이 충분한 다른 토큰을 사용하세요.
该令牌状态不可用토큰이 비활성화되었습니다.콘솔에서 토큰을 활성화하거나 새로 만드세요.
未提供令牌요청에 API 키가 포함되지 않았습니다.요청 헤더에 Authorization: Bearer sk-xxxxxx를 추가하세요.

권한 및 잔액 오류

이러한 오류는 보통 403을 반환합니다.

표시될 수 있는 메시지일반적인 원인해결 방법
用户额度不足, 剩余额度: ...이 요청을 처리할 계정 잔액이 부족합니다.계정에 충전한 뒤 다시 시도하세요.
预扣费额度失败, 用户剩余额度: ...예상 요청 비용을 충당할 잔액이 부족합니다.충전하거나 max_tokens를 줄이고 입력을 짧게 하세요.
您的 IP 不在令牌允许访问的列表中토큰에 IP 허용 목록이 있고 현재 IP가 허용되지 않습니다.허용된 IP를 사용하거나 콘솔에서 허용 목록을 업데이트하세요.
用户已被封禁계정이 정지되었습니다.자세한 내용은 지원에 문의하세요.
无权访问 xxx 分组토큰이 요청한 그룹에 접근할 수 없습니다.허용된 그룹을 사용하거나 접근 권한을 요청하세요.
该令牌无权访问模型 xxx토큰의 허용 모델 목록에 이 모델이 없습니다.허용된 모델을 사용하거나 콘솔에서 토큰의 모델 권한을 업데이트하세요.

요청 내용 오류

이러한 오류는 보통 400을 반환합니다.

표시될 수 있는 메시지일반적인 원인해결 방법
Invalid request, ...요청 본문을 파싱할 수 없습니다.JSON이 유효한지, Content-Type이 application/json인지 확인하세요.
未指定模型名称，模型名称不能为空요청에 model 필드가 없습니다.요청 본문에 올바른 model을 추가하세요.
检测到敏感词와 같은 메시지입력이 콘텐츠 안전 규칙에 걸렸습니다.입력을 조정한 뒤 다시 시도하세요.

요청 한도 오류

이러한 오류는 보통 429를 반환합니다.

표시될 수 있는 메시지일반적인 원인해결 방법
您已达到请求数限制：N分钟内最多请求M次성공한 요청의 한도에 도달했습니다.요청 빈도를 낮추고 한도 창이 초기화된 뒤 다시 시도하세요.
您已达到总请求数限制：...，包括失败次数...실패한 요청을 포함한 총 요청 한도에 도달했습니다.실패한 요청이 반복 루프인지 확인하고 원인을 고친 뒤 다시 시도하세요.

모델 및 경로 오류

이러한 오류는 보통 404 또는 503을 반환합니다.

표시될 수 있는 메시지일반적인 원인해결 방법
模型不存在모델 이름이 잘못되었거나 이 모델이 토큰에 활성화되어 있지 않습니다.모델 이름과 토큰의 모델 권한을 확인하세요.
无可用渠道현재 모델에 사용 가능한 경로가 없습니다.나중에 다시 시도하세요. 계속 사용할 수 없으면 지원에 문의하세요.

서버 오류

이러한 오류는 보통 500 또는 503을 반환합니다.

표시될 수 있는 메시지일반적인 원인해결 방법
내부 오류 메시지일시적인 서버 문제이거나 업스트림 서비스를 일시적으로 사용할 수 없습니다.나중에 다시 시도하세요. 계속되면 request id와 함께 지원에 문의하세요.

지원에 문의하기 전에

문제를 더 빨리 찾을 수 있도록 다음을 제공해 주세요.

  1. message, code, 모든 request id를 포함한 전체 오류 응답
  2. 문제가 발생한 대략적인 시간
  3. 호출한 모델 이름과 엔드포인트 URL
  4. API 키의 앞부분 몇 글자, 예: sk-abcd.... 전체 키는 보내지 마세요.
GitHub에서 이 페이지 편집