5분 만에 첫 호출 완료하기
Key 발급 → 요청 전송 → 모델 전환, 세 단계로 끝.
사전 조건
Lurus 계정 하나(가입하면 바로 무료 할당량 제공, 첫 단계에서 생성 안내) · Python 3.8+ / Node.js 18+ / Go 1.21+ / cURL(택일) · 기본 터미널 지식. 예상 소요 시간 5분.
계정 가입 —— 무료로 시작
가입하면 바로 무료 할당량을 받으며, 충전 없이도 이 튜토리얼을 완주할 수 있습니다.
이어서 API Key를 하나 생성합니다.
hub.lurus.cn에 접속하여 로그인 또는 가입
「토큰 관리」→「새 토큰 생성」으로 이동
생성된 Key를 복사(형식:
sk-xxxxxxxxxxxxxxxx)
보안 안내
API Key는 비밀번호와 같습니다. Git에 커밋하지 마세요, 프런트엔드 코드에 작성하지 마세요. 환경 변수로 전달하는 것을 권장합니다:
export LURUS_API_KEY="sk-your-key-here"첫 요청 보내기
사용하는 언어를 골라 복사하면 바로 실행됩니다.
모델 응답이 보이나요? 첫 호출에 성공했습니다 🎉
이번 요청은 가입 시 제공된 무료 할당량으로 처리되었으며, 한 푼도 들지 않았습니다. 다음 단계로 다른 모델을 시도해 보세요 —— 코드는 거의 손댈 필요가 없습니다.
모델 전환
model 파라미터만 바꾸면 되고, 다른 코드는 전혀 수정할 필요가 없습니다. 모델을 하나 고르면 아래 스니펫이 즉시 갱신되어 복사 후 바로 실행됩니다.
from openai import OpenAI
import os
client = OpenAI(base_url="https://hub.lurus.cn/v1", api_key=os.environ["LURUS_API_KEY"])
response = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)무엇을 골라야 할지 모르겠다면?
일상적 사용 → deepseek-chat(비용 최저, 중국어 최고)
복잡한 추론 → deepseek-reasoner
긴 문서 처리 → gemini-3-pro-preview
전체 비교는 지원 모델을 참고하세요.
잘 안 되나요? 먼저 여기를 확인하세요
401 Unauthorized 반환
{"error": {"code": "invalid_api_key", "type": "authentication_error"}}확인 사항:
- Key가
sk-로 시작하는지 - 요청 헤더 형식:
Authorization: Bearer sk-xxxx(Bearer 뒤에 공백이 있음에 유의) - Key가 「활성화」 상태인지(콘솔에서 확인)
"no available server" 반환
model이름 철자 확인(대소문자 구분)- 해당 Key가 이 모델에 접근할 권한이 있는지 확인
- Key를 방금 생성했다면 약 10초 후 다시 시도
스트리밍 응답은 어떻게 켜나요?
요청 본문에 "stream": true를 추가하세요. 자세한 내용은 스트리밍 응답Streaming스트리밍 응답으로, AI 모델이 전체 생성을 기다리지 않고 결과를 Token 단위로 반환하여 첫 글자 지연을 줄입니다.을 참고하세요.