먼저 실패한 단계 식별
서비스 상태를 확인한 후 계정 액세스, API 인증, 모델 발견, 추론 및 결제 문제를 분리하세요. 카탈로그에 모델이 나타나는 것은 라이브 가용성을 입증하지 않습니다. GET /v1/models은 연결된 배포를 나열합니다.
503 service_unavailable는 필요한 서비스가 요청을 수락할 수 없음을 의미합니다. 재시도하기 전에 서비스 상태와 API 참조를 확인하세요. 반복 요청으로 사용 불가능한 서비스를 활성화할 수 없습니다. 전용 GPU의 경우 확인된 프로비저닝을 기다리세요. 결제의 경우 주문 지침과 기록된 검증 상태를 따르세요. 주문을 새로 고쳐도 크레딧이 추가되지 않습니다.
응답을 기반으로 작업하세요. 추측이 아닙니다
HTTP 상태와 오류의 code 및 message을(를) 기록하세요. 애플리케이션 로직을 변경하기 전에 구성된 API 기본 URL, 정확한 모델 ID, 클라이언트 버전을 확인하세요.
- 401: Bearer 헤더와 키가 해지되었는지 확인하세요. 전체 키는 로그에 남기지 마세요.
- 403: 키의 허용 목록에서 허용된 모델을 선택하세요.
- 400 또는 413: JSON, 필수 필드, 출력 제한, 입력/출력 컨텍스트 총 예산을 확인하세요.
- 402: 계정에 최소 USD 100 이상의 확인된 적격 충전이 있는지 확인한 다음 사용 가능한 크레딧과 선택한 키의 예산을 확인하세요. 적격 계정은 USD 100 잔액을 유지할 필요가 없습니다.
- 429: 제공된 경우 Retry-After 헤더를 따르고, 제한된 재시도를 사용하며, 적용 가능한 서비스 한도를 확인하세요. 일일 무료 평가판 허용량은 없습니다.
- 502 또는 503: 제한된 재시도 전에 가용성과 오류 메시지를 확인하세요.
오류 가이드와 한도에서 복구 경로를 설명합니다. 새 요청은 새로운 작업을 만들 수 있습니다. 클라이언트 재시도가 중복 제거된다고 가정하지 마세요.
중단된 스트림과 보류 중인 크레딧을 함께 처리
브라우저 탭 닫힘, 시간 초과 또는 끊어진 스트림이 생성 중단을 증명하지 않습니다. 응답 식별자와 수신된 경우 최종 사용량 프레임을 저장하세요. 최종 사용량 프레임은 선택의 finish_reason 이후에 도착할 수 있습니다. 네트워크 청크가 반드시 완전한 이벤트는 아닙니다.
409 pending_reconciliation 또는 디스패치 후 업스트림 오류는 권위 있는 사용량이 확보될 때까지 크레딧을 예약된 상태로 유지할 수 있습니다. 보류를 해제하기 위해 중복 요청을 보내지 마세요. UTC 시간, 모델 및 키 이름을 콘솔 사용량과 비교하고 조정을 위해 요청 세부 정보를 보관하세요. 정리 시간은 보장되지 않습니다.
결제 문제의 경우 주문 참조, 자산, 네트워크, 금액 및 표시 상태를 기록하세요. 첫 번째 결제가 보류 중이라는 이유만으로 다른 결제를 보내지 마세요. 지갑 인출은 현재 사용할 수 없습니다. 활성화 전에 유료 GPU 주문을 취소하면 결제 금액이 WeightsAPI 계정 잔액으로 반환되며 지갑으로 자금이 이체되지 않습니다.
재현 가능한 증거를 준비하세요
유용한 보고서에는 작업, UTC 타임스탬프, 엔드포인트 경로, 모델 ID, SDK 또는 통합 및 버전, 스트리밍 설정, 출력 토큰 제한, 상태/오류, 예상 결과, 실제 결과가 포함됩니다. 응답 또는 거래 참조는 가능한 경우에만 포함하세요. 게이트웨이는 현재 모든 오류에 대해 지원 ID를 노출하지 않습니다.
문제를 재현하는 가장 작은 합성 예시를 추가하세요. 실제 대화, 고객 기록, 개인 문서는 가상의 텍스트로 교체하세요. 관련 재시도 횟수와 문제가 요청 간에 반복되는지 여부를 포함하세요. 스크린샷에는 공유할 의사가 없는 자격 증명, 잔액 또는 식별자를 제거한 후 오류와 컨텍스트가 표시되어야 합니다.
전용 GPU 주문의 경우 주문 참조 번호, 구성, 표시된 결제 또는 프로비저닝 상태를 포함해 주세요. 대기 중인 주문은 활성 머신이 아닙니다.
자격 증명과 고객 콘텐츠를 제외하세요
API 비밀 키, Authorization 헤더, 세션 쿠키, 개인 지갑 키, 복구 구문 또는 전체 환경 파일을 포함하지 마세요. 애플리케이션을 구분하려면 키 이름이나 의도적으로 축약된 접두사로 충분합니다. 공개 거래 참조는 여전히 활동을 지갑과 연결할 수 있습니다. 조사에 필요한 것만 공유하세요.
키가 노출된 경우 교체 키를 생성하고 애플리케이션을 업데이트한 다음 이전 키를 해지하세요. 해지는 새 승인을 차단합니다. 이전에 승인된 요청은 정상적으로 처리됩니다. 키 처리에 대해서는 인증을 참조하세요.
보고서 저장 및 연락처 세부 정보 확인
보고서를 복사하고 검토한 후 관련 요청 또는 주문 참조와 함께 보관하세요. 복사는 티켓을 제출하지 않습니다. 공식 지원 연락처와 서비스 시간은 게시되지 않았습니다. 확인된 채널만 사용하여 보고서를 공유하세요.
응답 목표, 에스컬레이션 연락처 및 서비스 크레딧은 설정되지 않았습니다. 보고서에 자격 증명과 민감한 고객 콘텐츠를 포함하지 마세요.