오류 코드, 인증, 속도 제한, 임시 차단, 인터페이스, 수수료 문제 문제 해결 방법. 완전한 검사 단계, 실무 검증, 오류 처리가 포함됩니다.

429의 흔한 오류

오류가 발생하면 먼저 HTTP 상태와 반환된 버전을 확인하세요 error.message、error.code 그리고 요청 번호. 동일한 상태 코드가 서로 다른 단계에서 나올 수 있으며, 근본 원인은 숫자만으로는 확인할 수 없습니다.

공통 상태

잔액 부족, 사용 불가, 가격 설정 미완료와 같은 비즈니스 오류도 읽고 본문으로 반환해야 합니다; 상태 코드나 프론트엔드 팝업만 볼 수는 없습니다.

429 꼭 '너무 많은 걸 요구하는 건 아니야'

429는 특정 계층이 요청을 제한한다는 것을 나타냅니다. 현재 각 자격증은 최대 동시에 처리할 수 있습니다 2 요청, 모델 호출 빈도 한계는 다음과 같습니다. 분당 60박자； 상류는 자체 자원과 사용량 제한도 있습니다.

• concurrency_limit: 기존 요청이 완료될 때까지 다음 요청을 보내기 전에 기다리세요. 스트림 요청은 종료될 때까지 동시성을 유지합니다.
• 정규 주파수 제한 또는 상류 429: 존중하세요 Retry-After(가능하다면) 제한된 횟수의 재시도와 점진적으로 길어지는 대기 시간을 사용하여 즉각적인 반복 요청을 피하세요.
• 페이지가 HTTP 오류 429를 직접 보여줍니다: 브라우저 페이지 요청도 제한될 수 있습니다; 새로고침하기 전에 잠시 기다려 주세요; 계속 발생하면 발생 시간과 경로를 관리자에게 남겨두세요.

일반적인 텍스트 문제로 잘못 판단되면, 요청 번호와 필요한 비민감 노트를 검토할 수 있습니다; 사용 가능한 키, 비밀번호, 또는 민감한 원본 텍스트를 모두 보내지 마십시오.

403 바우처를 통한 임시 봉인

content_policy_violation 이는 해당 요청이 사이트의 사용 제한을 충족했으며 상류로 전송되기 전에 거부되었음을 의미합니다.

credential_temporarily_blocked 귀환 403, 그리고 다음을 제공한다 Retry-After 대기 프롬프트: 같은 자격 증명이 30분 이내에 여러 번 규칙에 도달하면 30분간 일시정지하세요. 관련 콘텐츠를 중단하고 복구를 기다려 주세요; 키를 변경해서 시도하지 마세요. 이는 429 동시성 또는 빈도 제한과는 다릅니다.

인터페이스 주소 및 모델 문제

기본 URL은 다음과 같습니다. https://api.baiyun.si/v1, 채팅의 전체 주소는 다음과 같습니다 /v1/chat/completions, 답변 주소: /v1/responses。 중복 검사 /v1/v1, 그리고 클라이언트가 이 사이트에 열리지 않은 프로토콜을 선택했는지 여부도 포함됩니다.

모델명은 다음과 연관되어야 합니다모델 스퀘어그리고 현재 키는 /v1/models 일관되게 반환; 실제 호출명을 대체하기 위해 클라이언트 측 디스플레이 별칭을 사용하지 마세요.

스트리밍 및 비용 문제

채팅 SSE는 다음과 같습니다 [DONE]； 답변 SSE는 이벤트 종료 전체 내용을 읽어야 합니다. 네트워크 연결이 끊긴 후 일부 문자는 완전한 성공적인 응답으로 간주될 수 없습니다.

투입과 산출 매개변수가 확실한 비용 상한선을 보장하지는 않습니다. 정상적인 요청, 상류 진입 후 실패, 클라이언트 취소는 실제 소비 기록과 대조해야 하며; 이 모델 통화는 상류로 진행되지 않고 로컬에서 거부된 요청만이 요금을 부과하지 않습니다.

점검 시 어떤 것이 제공되나요?

1. 시간과 시간대.
2. 요청 번호, 모델명, 인터페이스 경로, HTTP 상태 등이 포함됩니다.
3. 키와 민감한 콘텐츠를 제거한 후 오류 메시지가 뜹니다.
4. 결제 관련 문의는 주문 번호와 상태를 제공하되, 결제 가맹점 키는 제공하지 마세요.

방송국은 여전히 점차 개선 중이며, 24시간 수동 대응이나 고정된 처리 시간 제한을 확정하지는 않았습니다.

실용 전 체크리스트

1. 자신의 계정과 접근 키를 준비하고, 타인의 공유 자격 증명은 사용하지 마세요.
2. 문제 해결 시 쉽게 재현할 수 있도록 클라이언트 버전, 시스템 및 모델을 기록합니다.
3. 원본 설정이나 스크린샷을 저장하고, 키, 인증 코드, 비공개 콘텐츠를 숨기세요.
4. 테스트가 한 문장과 단일 요청에서 시작해 소량의 DK를 소모할 수 있음을 확인하세요.
5. 추가 기능을 활성화할지 결정하기 전에 현재 모델 플라자와 상태 페이지를 검토하세요.

상세한 조사: 문제의 범위를 순서대로 좁히기

먼저 계좌가 완성되었는지, 키가 유효한지, DK 잔액이 충분한지 확인한 후, 프로토콜, 주소, 모델을 확인하세요. 같은 키를 사용해 최소 텍스트 요청을 만드세요; 성공 후에야 부착물, 도구를 복원하거나 각 아이템을 자동으로 재시도합니다. 클라이언트 설정을 저장한 후, 이전 벤더를 이전 세션에서 사용하지 않도록 세션을 다시 열어보세요.

이 부분이 학습되었는지 확인하는 방법

"구성 성공적으로 저장됨" 프롬프트만 확인하지 마세요. 현재 기본 URL, 키 사용, 선택한 모델, 요청 프로토콜을 명확히 표시할 수 있어야 하며, 해당 콘솔에서 작업 결과를 검증할 수 있어야 합니다. 클라이언트 측 튜토리얼은 단일 실제 평문 응답과 해당 로그를 초기 완료 표준으로 사용합니다; 계정 튜토리얼은 포괄적인 보안 정보를 기반으로 하며; 청구 튜토리얼은 원금, 채널 수수료, DK 간의 대응 관계를 표준으로 사용합니다.

오류가 발생하면 발생 시간, HTTP 상태, 익명화된 오류의 내용, 그리고 실제 예상 결과를 기록하세요. 전체 페이지 키를 스크린샷하지 말고, 비밀번호나 인증 코드를 다른 사람에게 알려주지 마세요. 401의 경우 인증을 먼저 해결해야 하며, 400의 경우 매개변수를 먼저 해결해야 하며, 429의 경우 집중적인 재시도를 중단해야 하며, 404의 경우 요청 경로와 상류 검증을 검증해야 하며, 재충전이 모든 오류를 해결할 수는 없습니다.

연습하기에 적합한 작은 과제

이 섹션의 최소 단계를 자신의 테스트 환경에서 완료하며, "처음 어떻게 설정했는지, 어떤 항목을 수정했는지, 어떤 결과를 보았는지"를 텍스트로 기록하세요. 생산 데이터, 실제 결제, 복구 불가능한 명령어를 연습으로 간주하지 마십시오. 이 섹션에서 제공하는 기능을 넘어서는 기능을 발견하면, 기능 추가를 고려하기 전에 해당 프로토콜 튜토리얼을 먼저 확인하세요; 한 번에 한 가지 구성만 변경하면 어떤 단계에서 오류가 발생하는지 쉽게 판단할 수 있습니다.

다음 단계는 버전의 경계입니다

전체 학습 지도로 돌아가기 · 간소화된 API 사이트 구성 · 이 사이트의 실시간 현황。

튜토리얼은 2026년 10월 9일에 작성되었습니다. 구체적인 인터페이스와 기능은 클라이언트와 업스트림 버전에 따라 다를 수 있습니다; 구성 지침이 모든 클라이언트 버전이 테스트를 통과했다는 의미는 아닙니다. 잔액 지급, QQ / Alipay 로그인, 오픈 채널에 대해서는 실제 페이지 페이지를 참조해 주세요; 압축 인터페이스: 이전에는 업스트림 404 및 RAW 이미지 채널이 지원되지 않았으므로, 설정 파일이 자동으로 삭제될 수 있다고 가정하지 마십시오.