백운 API 튜토리얼: 빠르게 시작하기
로그인, 입력, 키 생성부터 첫 번째 평문 API 요청까지. 완전한 검사 단계, 실무 검증, 오류 처리가 포함됩니다.
시작합시다
이 페이지는 웹사이트 채팅이나 API 호출을 통해 사이트를 사용하기 시작하는 데 도움을 줍니다. 현재 서비스 범위는 다음과 같습니다:완전하고 검증 가능한 평문 요청。
웹사이트에서 직접 경험해 보세요
- 이 사이트 계정에 가입하거나 로그인하세요.
- 오픈지갑도켄(WordKnife, DK) 금액과 실제 위안화 결제 금액을 확인한 후, 알리페이나 위챗으로 충전하세요; 현재 단가(단가)는 0.30위안/DK입니다.
- 오픈대화 경험오픈 모델을 선택하고 먼저 짧고 일반적인 텍스트 질문을 제출하세요.
- 존재조종 콘솔사용 및 소비 기록을 확인하세요.
현재 소비는 균형에 기반하며, 회원 가입은 필요하지 않습니다. 재충전하거나 게임을 부르기 전에 꼭 읽어주세요사용 규칙。
애플리케이션용 호출 키를 생성하세요
존재키 관리모델 호출을 위한 API 키를 생성하고; 실제 필요에 따라 균형과 모델 한도를 설정하고, 저장 후에는 제대로 보관하세요.
이 앱은모델 호출 키웹 로그인 비밀번호가 아닙니다. 공개 코드, 스크린샷, 채팅 콘텐츠, 브라우저에서 접근 가능한 프론트엔드 코드에 키를 작성하지 마십시오. 유출된 키는 취소되어 키 관리에서 다시 생성되어야 합니다.
클라이언트 구성
| 구성 항목 | 현재 채워진 콘텐츠 |
|---|---|
| API Base URL | https://api.baiyun.si/v1 |
| API Key | 사이트 키 관리가 생성한 통화 키 |
| 모델 | 예를 들어, gpt-6-luna; 정확한 목록은 모델 스퀘어를 참조하세요 |
| 인터페이스 | 채팅 완료 또는 응답을 위한 텍스트 모드 |
클라이언트마다 주소 정의가 다릅니다: 채우세요 Base URL 보통 그 시점에 보관됩니다 /v1； 전체 채팅 주소를 작성해야 한다면 작성해 주세요 https://api.baiyun.si/v1/chat/completions。 치우지 마 /v1 두 번 이어 부합을 반복하세요. 모든 클라이언트, 플러그인, 함수가 기본적으로 호환되는 것은 아닙니다.
첫 번째 API 요청
키 입력 시 공유 터미널이나 녹화 화면에 들어가지 않도록 로컬 터미널에서 환경 변수를 설정하세요:
read -r -s -p '请输入本站 API 密钥：' BAIYUN_API_KEY
printf '\n'
export BAIYUN_API_KEY
curl --fail-with-body https://api.baiyun.si/v1/chat/completions \
-H "Authorization: Bearer $BAIYUN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-6-luna",
"messages": [{"role": "user", "content": "你好，请用一句话介绍你能帮我做什么。"}],
"stream": false
}'성공적인 요청은 생성된 텍스트와 사용 정보를 반환하고, 나열된 기준 단가에서 DK 잔액을 차감합니다. 1 DK는 선택된 상업 API 참조 견적에 따라 1 USD로 가격이 매겨진 토큰 배치를 의미하며, 고정 토큰 수량이나 현금 미국 달러 환전 가능한 토큰은 아닙니다. 위의 일반적인 요청들도 소량의 소비를 생성합니다.
현재 0.30위안/DK는 이 사이트의 충전 가격이며, 실제 테스트로 입증된 정확한 구독 비용이 아닙니다; 동일한 토큰 배치의 기준 가치와 구독 비용은 위안화 또는 엔화 환산으로 표시됩니다3단계 청구 지침。
출력을 계속 받고 싶다면 확인해 보세요채팅 스트리밍 예시； 응답을 사용할 때, 앱에서 이를 확인할 수 있습니다응답 예시。
호출 가능한 모델을 확인해 보세요
모델 목록 인터페이스는 키 인증도 필요로 합니다:
curl --fail-with-body https://api.baiyun.si/v1/models \
-H "Authorization: Bearer $BAIYUN_API_KEY"현재 키를 실제로 반환하는 모델이 우선합니다. 모델이 존재하지 않거나 사용할 수 없는 경우, 모델 이름, 키 제한, 균형을 확인하시고, 지원되지 않는 요청을 반복적으로 재시도하지 마세요.
실용 전 체크리스트
- 자신의 계정과 접근 키를 준비하고, 타인의 공유 자격 증명은 사용하지 마세요.
- 문제 해결 시 쉽게 재현할 수 있도록 클라이언트 버전, 시스템 및 모델을 기록합니다.
- 원본 설정이나 스크린샷을 저장하고, 키, 인증 코드, 비공개 콘텐츠를 숨기세요.
- 테스트가 한 문장과 단일 요청에서 시작해 소량의 DK를 소모할 수 있음을 확인하세요.
- 추가 기능을 활성화할지 결정하기 전에 현재 모델 플라자와 상태 페이지를 검토하세요.
상세한 조사: 문제의 범위를 순서대로 좁히기
먼저 계좌가 완성되었는지, 키가 유효한지, DK 잔액이 충분한지 확인한 후, 프로토콜, 주소, 모델을 확인하세요. 같은 키를 사용해 최소 텍스트 요청을 만드세요; 성공 후에야 부착물, 도구를 복원하거나 각 아이템을 자동으로 재시도합니다. 클라이언트 설정을 저장한 후, 이전 벤더를 이전 세션에서 사용하지 않도록 세션을 다시 열어보세요.
이 부분이 학습되었는지 확인하는 방법
"구성 성공적으로 저장됨" 프롬프트만 확인하지 마세요. 현재 기본 URL, 키 사용, 선택한 모델, 요청 프로토콜을 명확히 표시할 수 있어야 하며, 해당 콘솔에서 작업 결과를 검증할 수 있어야 합니다. 클라이언트 측 튜토리얼은 단일 실제 평문 응답과 해당 로그를 초기 완료 표준으로 사용합니다; 계정 튜토리얼은 포괄적인 보안 정보를 기반으로 하며; 청구 튜토리얼은 원금, 채널 수수료, DK 간의 대응 관계를 표준으로 사용합니다.
오류가 발생하면 발생 시간, HTTP 상태, 익명화된 오류의 내용, 그리고 실제 예상 결과를 기록하세요. 전체 페이지 키를 스크린샷하지 말고, 비밀번호나 인증 코드를 다른 사람에게 알려주지 마세요. 401의 경우 인증을 먼저 해결해야 하며, 400의 경우 매개변수를 먼저 해결해야 하며, 429의 경우 집중적인 재시도를 중단해야 하며, 404의 경우 요청 경로와 상류 검증을 검증해야 하며, 재충전이 모든 오류를 해결할 수는 없습니다.
연습하기에 적합한 작은 과제
이 섹션의 최소 단계를 자신의 테스트 환경에서 완료하며, "처음 어떻게 설정했는지, 어떤 항목을 수정했는지, 어떤 결과를 보았는지"를 텍스트로 기록하세요. 생산 데이터, 실제 결제, 복구 불가능한 명령어를 연습으로 간주하지 마십시오. 이 섹션에서 제공하는 기능을 넘어서는 기능을 발견하면, 기능 추가를 고려하기 전에 해당 프로토콜 튜토리얼을 먼저 확인하세요; 한 번에 한 가지 구성만 변경하면 어떤 단계에서 오류가 발생하는지 쉽게 판단할 수 있습니다.
다음 단계는 버전의 경계입니다
전체 학습 지도로 돌아가기 · 간소화된 API 사이트 구성 · 이 사이트의 실시간 현황。
튜토리얼은 2026년 10월 9일에 작성되었습니다. 구체적인 인터페이스와 기능은 클라이언트와 업스트림 버전에 따라 다를 수 있습니다; 구성 지침이 모든 클라이언트 버전이 테스트를 통과했다는 의미는 아닙니다. 잔액 지급, QQ / Alipay 로그인, 오픈 채널에 대해서는 실제 페이지 페이지를 참조해 주세요; 압축 인터페이스: 이전에는 업스트림 404 및 RAW 이미지 채널이 지원되지 않았으므로, 설정 파일이 자동으로 삭제될 수 있다고 가정하지 마십시오.