API 통합 튜토리얼

백윤 API 튜토리얼: 파이썬, Node.js, 그리고 랑체인

백윤 SI 편집팀2026-10-09읽는 데 약 6분 정도

서버 측 환경 변수, 응답/채팅 SDK 최소 예제와 재시도. 완전한 검사 단계, 실무 검증, 오류 처리가 포함됩니다.

파이썬, Node.js, 그리고 랭체인

서버가 키를 저장합니다

키는 프로세스 환경 변수를 통과합니다 BAIYUN_API_KEY 읽어봐. 브라우저 웹페이지와 모바일 앱은 내장 공유 키를 가질 수 없습니다; 요청을 대신 보내려면 자체 백엔드 인증과 쿼터가 필요합니다. 배포 전에 로그에 요청 헤더나 환경 변수가 인쇄되어 있는지 확인하세요.

Python

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["BAIYUN_API_KEY"],
                base_url="https://api.baiyun.si/v1",
                timeout=120.0, max_retries=0)
response = client.responses.create(model="gpt-6-luna",
                                   input="用一句话说明 Token 是什么。")
print(response.output_text)

output_text SDK가 제공하는 편리함; REST JSON을 직접 파싱할 때는 트래버스가 필요합니다 output 메시지 항목의 텍스트 필드. 의존성은 격리된 환경에 설치되어야 하며, 프로젝트 락 파일은 유지해야 합니다; 테스트 목적으로 전체 프로덕션 프로젝트를 업그레이드하지 마세요.

Node.js

import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: process.env.BAIYUN_API_KEY,
  baseURL: 'https://api.baiyun.si/v1',
  maxRetries: 0,
  timeout: 120000,
});
const stream = await client.chat.completions.create({
  model: 'gpt-6-luna', stream: true,
  messages: [{role: 'user', content: '你好'}],
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

LangChain

OpenAI 호환 주소를 지원하는 모델 어댑터를 사용하고, API 키, 기본 URL, 모델을 현재 버전으로 설정하세요. 먼저 평문을 호출한 후 링크, 검색 또는 도구를 추가합니다; 프레임워크가 자동으로 추가하는 추가 매개변수는 여전히 사이트의 오픈 스코프를 준수해야 하며; 프레임워크 이름을 호환성 보장으로 간주하지 마십시오.

실수와 재도전

첫째, HTTP 상태, SDK 파싱 오류, 비즈니스 반환 오류를 구분합니다. 생성 인터럽트는 이미 돈을 소모할 수 있으며; 무한히 자동 재시도하지 않습니다; 429 후퇴, 401 수리 자격 증명, 400 수리 매개변수. 연결 타임아웃이 발생하면 상태 페이지와 네트워크를 확인한 후 재시도 여부를 결정하세요.

공식 Python SDK 프로젝트 · 공식 Node SDK 프로젝트 · 공식 랭체인 문서

실용 전 체크리스트

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

상세한 문제 해결: 요청 문제와 코드 문제 분리

먼저 동일한 키와 모델로 최소 컬을 실행한 후, SDK의 실제 주소, 요청 프로토콜, 매개변수를 비교합니다. curl이 성공했지만 SDK가 실패하면, 프록시 환경, SDK 자동 재시도, 타임아웃, 추가 필드 문제를 해결하세요. 오류 로그에 Authorization을 출력하지 마세요; 배포 시 키는 프론트엔드 빌드 변수로 작성할 수 없습니다.

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

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

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

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

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

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

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

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

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