백운(Baiyun) API 튜토리얼: 체리 스튜디오 통합 가이드
구성 단계, 적용 가능한 전제 조건, 그리고 일반적인 호환성 문제들. 완전한 검사 단계, 실무 검증, 오류 처리가 포함됩니다.
체리 스튜디오 입구 안내서
사용 전 준비
존재키 관리이 도구에 대해 별도의 콜 키를 만들어 계좌가 완료되었고 DK 잔액이 충분한지 확인하세요. 클라이언트 버전은 항목 이름에 영향을 미칩니다; 이 페이지는 구성 항목을 설명합니다; 실제 인터페이스의 현재 버전을 참고해 주세요.
구성 단계
설정에서 모델 서비스를 열고 OpenAI 호환 벤더를 추가; 기본 URL과 본인이 직접 호출 키를 입력하세요. 모델 플라자에 정확한 모델명을 수동으로 추가하고 저장한 뒤, 새 채팅 세션에서 선택하세요.
| 구성 항목 | 내용을 채워 넣으세요 |
|---|---|
| Base URL | https://api.baiyun.si/v1 |
| API Key | 이 클라이언트별 통화 키 |
| 모델 예시 | gpt-6-luna |
| 일반 채팅 프로토콜 | OpenAI Compatible Chat Completions |
| 코덱스 벤더 계약서 | Responses |
최소한의 검증
먼저, 온라인 검색, 이미지, 첨부파일, 지식 베이스, 자동 실행 도구를 끄고, 그다음 평범한 문장을 보내세요. 고객이 실제로 우리 공급업체를 선택했는지 확인한 다음,사용 기록이 모델과 소비량을 확인하세요. 클라이언트 연결 버튼은 모델 목록만 확인할 수 있으며 실제 채팅을 대체할 수 없습니다.
자주 묻는 질문
주소가 완전한 엔드포인트를 요구할 경우, 채팅 주소는 다음과 같습니다. https://api.baiyun.si/v1/chat/completions； 기본 URL을 요청할 때는 테이블에 있는 주소를 사용하세요. 출현 /v1/v1 아니면 반복하는 거야 /chat/completions 그때 주소가 먼저 변경되었습니다. 401 키 및 유효 공급업체 검증; 429 병렬 테스트 중지하고 기다려; 404 체크 프로토콜과 모델; 지원되지 않는 프로토콜을 다른 모델로 위장하지 마십시오.
기능 및 데이터
이 페이지는 구성 지침을 제공하며 각 클라이언트 버전에 대한 완전한 실인 테스트를 완료하지 않습니다. 커스텀 모델은 고객의 공식 모델 완성, 도구 또는 구독 기능에 대한 접근을 보장하지 않습니다. 제3자 클라이언트는 세션을 업로드하거나 동기화된 데이터를 구성할 수 있습니다; 사용 전에 개인정보 설정을 검토하세요; 키가 포함된 구성을 공개적으로 내보내지 마세요.
실용 전 체크리스트
- 자신의 계정과 접근 키를 준비하고, 타인의 공유 자격 증명은 사용하지 마세요.
- 문제 해결 시 쉽게 재현할 수 있도록 클라이언트 버전, 시스템 및 모델을 기록합니다.
- 원본 설정이나 스크린샷을 저장하고, 키, 인증 코드, 비공개 콘텐츠를 숨기세요.
- 테스트가 한 문장과 단일 요청에서 시작해 소량의 DK를 소모할 수 있음을 확인하세요.
- 추가 기능을 활성화할지 결정하기 전에 현재 모델 플라자와 상태 페이지를 검토하세요.
상세한 조사: 문제의 범위를 순서대로 좁히기
먼저 계좌가 완성되었는지, 키가 유효한지, DK 잔액이 충분한지 확인한 후, 프로토콜, 주소, 모델을 확인하세요. 같은 키를 사용해 최소 텍스트 요청을 만드세요; 성공 후에야 부착물, 도구를 복원하거나 각 아이템을 자동으로 재시도합니다. 클라이언트 설정을 저장한 후, 이전 벤더를 이전 세션에서 사용하지 않도록 세션을 다시 열어보세요.
이 부분이 학습되었는지 확인하는 방법
"구성 성공적으로 저장됨" 프롬프트만 확인하지 마세요. 현재 기본 URL, 키 사용, 선택한 모델, 요청 프로토콜을 명확히 표시할 수 있어야 하며, 해당 콘솔에서 작업 결과를 검증할 수 있어야 합니다. 클라이언트 측 튜토리얼은 단일 실제 평문 응답과 해당 로그를 초기 완료 표준으로 사용합니다; 계정 튜토리얼은 포괄적인 보안 정보를 기반으로 하며; 청구 튜토리얼은 원금, 채널 수수료, DK 간의 대응 관계를 표준으로 사용합니다.
오류가 발생하면 발생 시간, HTTP 상태, 익명화된 오류의 내용, 그리고 실제 예상 결과를 기록하세요. 전체 페이지 키를 스크린샷하지 말고, 비밀번호나 인증 코드를 다른 사람에게 알려주지 마세요. 401의 경우 인증을 먼저 해결해야 하며, 400의 경우 매개변수를 먼저 해결해야 하며, 429의 경우 집중적인 재시도를 중단해야 하며, 404의 경우 요청 경로와 상류 검증을 검증해야 하며, 재충전이 모든 오류를 해결할 수는 없습니다.
연습하기에 적합한 작은 과제
이 섹션의 최소 단계를 자신의 테스트 환경에서 완료하며, "처음 어떻게 설정했는지, 어떤 항목을 수정했는지, 어떤 결과를 보았는지"를 텍스트로 기록하세요. 생산 데이터, 실제 결제, 복구 불가능한 명령어를 연습으로 간주하지 마십시오. 이 섹션에서 제공하는 기능을 넘어서는 기능을 발견하면, 기능 추가를 고려하기 전에 해당 프로토콜 튜토리얼을 먼저 확인하세요; 한 번에 한 가지 구성만 변경하면 어떤 단계에서 오류가 발생하는지 쉽게 판단할 수 있습니다.
다음 단계는 버전의 경계입니다
전체 학습 지도로 돌아가기 · 간소화된 API 사이트 구성 · 이 사이트의 실시간 현황。
튜토리얼은 2026년 10월 9일에 작성되었습니다. 구체적인 인터페이스와 기능은 클라이언트와 업스트림 버전에 따라 다를 수 있습니다; 구성 지침이 모든 클라이언트 버전이 테스트를 통과했다는 의미는 아닙니다. 잔액 지급, QQ / Alipay 로그인, 오픈 채널에 대해서는 실제 페이지 페이지를 참조해 주세요; 압축 인터페이스: 이전에는 업스트림 404 및 RAW 이미지 채널이 지원되지 않았으므로, 설정 파일이 자동으로 삭제될 수 있다고 가정하지 마십시오.