호출 키를 만들고, 목적을 분리하며, 모델을 제한하고, 유출된 키를 철회하세요. 완전한 검사 단계, 실무 검증, 오류 처리가 포함됩니다.

API 키를 생성하고 안전하게

먼저, 계좌를 완성하세요

존재등록 및 로그인이메일 인증 코드, 로그인 비밀번호, 계정 정보를 입력하세요. QQ / Alipay 인증 계좌가 불완전한 경우, 모델에 전화해 입금하기 전에 이 단계를 완료해야 합니다.

통화 키 생성

1. 오픈키 관리, 키를 생성하는 것을 선택하세요.
2. 이름에는 "개인 체리 스튜디오"나 "프로젝트 개발 환경"과 같은 목적이 명확히 명확히 드러납니다.
3. 유효 기간, 사용 가능한 한도, 모델 제한을 페이지의 실제 옵션에 따라 설정; 기본 그룹을 사용할 때는 숨겨진 경로를 수동으로 찾을 필요가 없습니다.
4. 저장 후에는 키를 자신의 비밀번호 관리자나 클라이언트에 복사하세요. 웹 로그인 비밀번호나 백엔드 관리 토큰을 사용하지 마세요.
5. 사용시작합시다간단한 인정 요청. 실제 소비 잔액이 생성됩니다.

각 용도마다 별도의 키가 있습니다

키는 컴퓨터 클라이언트, 서버 프로젝트, 임시 실험마다 별도로 생성되어, 로그에서 용도를 구분하고 개별적으로 철회하는 것이 용이합니다. 모델 제한은 콜 가능 범위 내에만 있으며 계좌 잔액을 증가시키지 않습니다; 키 한도와 남은 계좌 잔액 모두 충분한 금액이어야 합니다.

열쇠가 유출될 때

키 관리에서 즉시 이전 키를 취소하고, 새 키를 만들고, 클라이언트를 업데이트하며, 최근 사용 기록을 확인하세요. 공개된 스크린샷이나 Git 파일만 삭제한다고 해서 이미 유출된 키는 취소되지 않습니다. 전체 키를 고객 서비스에 보내지 마세요; 오류 코드, 시간, 그리고 둔감해진 요청 정보를 제공하세요.

주소 검증

기본 URL은 https://api.baiyun.si/v1。 전체 채팅 주소는 https://api.baiyun.si/v1/chat/completions； 전체 답변 주소는 https://api.baiyun.si/v1/responses。 어떤 항목을 채울지는 클라이언트 측 필드의 의미에 따라 다릅니다; 명확히 말하지 마세요 /v1/v1。

실용 전 체크리스트

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

상세 조사: 어떤 바우처를 혼합해서는 안 되는지

로그인 비밀번호는 계정 로그인에만 사용되며, 모델 호출 키는 /v1 모델 요청에만 사용됩니다. 백엔드 관리 PAT/대시보드 세션은 관리 권한을 가지며 일반 클라이언트와 통합할 수 없습니다. 여러 사람이 같은 키를 공유하면 로그와 할당량이 혼동되어 각 장치나 프로젝트별로 고유한 키를 우선적으로 생성하게 됩니다.

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

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

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

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

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

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

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

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