API 통합 튜토리얼

백윤 API 튜토리얼: 채팅 텍스트 인터페이스

백윤 SI 편집팀2026-10-09읽는 데 약 7분 정도 걸립니다

채팅 완료가 SSE 스트리밍과 동기화되는 일반 텍스트 요청 예시. 완전한 검사 단계, 실무 검증, 오류 처리가 포함됩니다.

채팅 완성 텍스트 인터페이스

인터페이스 주소:POST https://api.baiyun.si/v1/chat/completions。

현재 OpenAI의 채팅 프로토콜을 명시적으로 지원하는 클라이언트를 위해 채팅 스타일의 평문 대화가 제공됩니다. 사이트 키 사용을 요청하고, 이 대화에 필요한 전체 텍스트 맥락을 제출하세요.

요청 구조

{
  "model": "gpt-6-luna",
  "messages": [
    {"role": "system", "content": "用简洁的中文回答。"},
    {"role": "user", "content": "请解释什么是 Token。"}
  ],
  "stream": false
}

model 이 사이트에서 실제로 이용 가능한 모델명은 다음과 같습니다;messages 문자 메시지는 순서대로 제출되었고;stream 동기화 리턴을 할지 스트리밍할지 결정하세요. 이 글에서는 오픈 기본 텍스트 구조만을 제시합니다; 복잡한 SDK 매개변수와 확장 기능은 기본적으로 제공되어서는 안 됩니다.

동기 통화

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":"用一句话解释 Token。"}],"stream":false}'

생성된 텍스트는 다음 주소에 위치해 있습니다. choices[].message.content； 복용량 정보는 여기에서 확인할 수 있습니다 usage。 특정 콘텐츠, 토큰 수, 수수료는 이 시점의 실제 응답 및 소비 기록에 따라 달라집니다.

스트림 호출

curl --no-buffer --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":"用三句话介绍 Token。"}],
    "stream":true,
    "stream_options":{"include_usage":true}
  }'

SSE를 이용한 스트림 반환: read(읽음) data: JSON, 순서대로 연결하세요 choices[].delta.content。data: [DONE] 개울의 끝을 나타냅니다; 활성화됨 include_usage 사용 후 마지막에 있는 사용 메시지는 반드시 유지해야 합니다. 모든 SSE 샤드를 독립적인 HTTP 응답으로 취급하지 마세요.

대화 맥락과 매개변수 경계

현재 채널은 모델의 기본 샘플링을 사용합니다.temperature、top_p、frequency_penalty 그리고 presence_penalty 현재 조절 가능한 컨트롤은 제공되지 않습니다; 클라이언트 측의 일반적인 기본 값은 호환성 처리를 통해 제거되며, 모델의 샘플링 설정은 변경되지 않습니다.

여러 라운드의 대화가 있어야 합니다 messages 필요한 완전한 텍스트 이력을 제출하세요. 현재 외부 도구, 네트워킹, 이미지, 파일 기능은 중단되어 있으며, 외부 기록이 확인되지 않은 텍스트 제출을 우회할 방법이 없습니다.

일부 모델이나 클라이언트는 출력 매개변수를 다르게 지원합니다. 작성해 달라고 요청해도 max_tokens、max_completion_tokens 또는 8192 같은 값도이 사이트가 보장하는 고정된 출력 길이나 비용 한도로 간주할 수 없습니다。 간단한 요청부터 시작해 지출 기록을 확인하고, 자신에게 맞는 키 잔액 한도를 설정하세요.

같은 바우처는 최대 동시에 처리할 수 있습니다 2 요청； 모델 호출도 주파수에 의해 제한됩니다. 429를 만나면 기다렸다가 누르세요오증원인을 파악하고 고주파 루프 재시도를 피하세요.

실용 전 체크리스트

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

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

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

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

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

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

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

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

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

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

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

커뮤니티로 돌아가 계속 읽어보세요 제 경험을 공유합니다