빠른 시작

이 가이드는 첫 LLM API 호출 과정을 안내합니다. 서비스를 활성화하고 사용량을 충전한 뒤 키를 생성하고 curl, Python, Node.js로 요청을 전송합니다.

#연결 정보

LLM API → 계정 개요 페이지의 API 정보 패널에는 자주 사용하는 엔드포인트가 나열되어 있으며, 각 항목에 복사 버튼이 있습니다.

#1단계: 서비스 활성화

1. 콘솔에 로그인하고 LLM API → 계정 개요 (/llm/account)를 엽니다.
2. 처음 방문하면 서비스가 활성화되지 않았다는 안내가 표시됩니다. 지금 활성화를 클릭합니다.
3. 활성화되면 페이지에 계정 데이터, 사용 통계, 차트 및 API 정보가 표시됩니다.

#2단계: 사용량 충전

모델 호출 시 LLM 계정의 사용 가능량이 차감됩니다. 다음 두 가지 방법으로 사용량을 충전할 수 있습니다.

• 기본 계정 잔액에서 이체: 계정 개요의 현재 잔액 카드에서 이체를 클릭하고 금액을 입력한 뒤 이체 확인을 클릭합니다. 최소 이체 금액은 1이며, 대화상자에 충전될 사용량이 표시됩니다.
• 충전 코드: 코드가 있다면 교환 코드로 충전 카드에 입력하고 교환을 클릭합니다.

기본 잔액을 먼저 충전하려면 현재 잔액 카드에서 충전을 클릭합니다. 결제 센터 → 잔액 (/billing/balance)이 열립니다.

#3단계: API 키 생성

1. LLM API → 토큰 관리 (/llm/tokens)를 엽니다.
2. 오른쪽 상단의 키 생성을 클릭합니다.
3. 이름을 입력합니다. 필수 항목입니다. 나머지는 기본값(기본 그룹, 모델 제한 없음, IP 제한 없음, 만료 없음)으로 두어도 됩니다. 각 옵션의 기능은 API 키, 사용량 한도 및 사용 내역을 참조하십시오.
4. 생성을 클릭합니다. "새 키가 생성되었습니다" 대화상자가 열리면 sk-로 시작하는 전체 키를 복사합니다.

#4단계: 모델 선택

LLM API → 모델 및 가격 (/llm/models)에서 모델 이름과 가격을 확인하거나 API로 조회합니다.

curl https://llm.yeap.cloud/v1/models \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY"

아래 예제는 gpt-4o-mini를 사용합니다. 모델 사용 가능 여부는 키의 그룹과 플랫폼이 현재 제공하는 모델에 따라 다릅니다. 모델 페이지를 확인하고 원하는 모델 이름으로 바꿉니다.

#5단계: 요청 전송

#curl

curl https://llm.yeap.cloud/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Introduce yourself in one sentence."}
    ]
  }'

응답을 스트리밍하려면 요청 본문에 "stream": true를 추가합니다. 그러면 응답이 Server-Sent Events(SSE) 형식으로 나뉘어 전송됩니다.

#Python(openai SDK)

먼저 SDK를 설치합니다: pip install openai.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["YEAP_LLM_API_KEY"],
    base_url="https://llm.yeap.cloud/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Introduce yourself in one sentence."}],
)
print(resp.choices[0].message.content)

# Streaming
stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Write a four-line poem."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

#Node.js(openai SDK)

먼저 SDK를 설치합니다: npm install openai.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.YEAP_LLM_API_KEY,
  baseURL: "https://llm.yeap.cloud/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "Introduce yourself in one sentence." }],
});
console.log(resp.choices[0].message.content);

#임베딩 예제

curl https://llm.yeap.cloud/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY" \
  -d '{"model": "text-embedding-3-small", "input": "Yeap Cloud"}'

#6단계: 사용 내역 확인

호출이 완료되면 LLM API → 요청 로그를 열어 모델, 입력 및 출력 토큰 수, 비용을 확인합니다. 자세한 내용은 API 키, 사용량 한도 및 사용 내역을 참조하십시오.

#문제 해결

• "토큰이 제공되지 않음" 메시지와 함께 401이 반환되는 경우: 헤더가 정확히 Authorization: Bearer sk-...인지, Bearer 뒤에 공백이 하나 있는지 확인합니다.
• 사용 가능량 부족: 계정의 사용 가능량 또는 키의 사용량 한도가 소진된 상태입니다. 계정의 경우 이체하거나 코드를 사용해 사용량을 추가로 충전합니다. 키의 경우 API 키에서 한도를 높이거나 무제한 사용량을 활성화합니다.
• 모델을 사용할 수 없는 경우: 모델이 키의 그룹에 없거나 키의 모델 제한에 의해 제외된 상태입니다. 모델 페이지를 확인하거나 다른 그룹 또는 모델로 전환합니다.
• 요청이 거부되고 키에 IP 제한이 설정된 경우: 서버의 아웃바운드 IP가 허용 목록에 있는지 확인합니다.
• 타사 클라이언트: 공급자 유형으로 "OpenAI 호환"을 선택하고 주소를 https://llm.yeap.cloud/v1로 설정한 뒤 sk-... 키를 붙여 넣습니다. 일부 클라이언트는 https://llm.yeap.cloud만 입력받고 /v1을 직접 추가합니다.