빌링AI

Quick Start

5분 안에 빌링AI API로 첫 번째 AI 응답을 받아보세요.

1

API Key 발급

  1. 1.빌링AI에 가입하고 대시보드에 로그인합니다.
  2. 2.좌측 메뉴에서 API Key 페이지로 이동합니다.
  3. 3."새 API Key 발급" 버튼을 클릭하여 Key를 생성합니다.
  4. 4.발급된 Key를 안전한 곳에 저장합니다. Key는 발급 시 1회만 표시됩니다.

주의: API Key는 비밀번호와 같습니다. 코드에 직접 입력하지 말고, 환경 변수로 관리하세요.

2

첫 번째 요청

발급받은 API Key로 텍스트 생성 API를 호출해보세요. 아래 예제의sk-proj-your-api-key부분을 실제 Key로 교체하세요.

curl -X POST https://api.billing-ai.kr/api/v1/chat/completions \
  -H "Authorization: Bearer sk-proj-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-4",
    "messages": [
      {"role": "user", "content": "한국의 수도는 어디인가요?"}
    ],
    "temperature": 0.7,
    "max_tokens": 256
  }'
3

응답 확인

성공적인 요청은 아래와 같은 JSON 응답을 반환합니다.

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1711234567,
  "model": "gpt-5-4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "한국의 수도는 서울입니다."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 12,
    "total_tokens": 27
  }
}

주요 필드 설명

  • choices[0].message.contentAI 모델의 응답 텍스트
  • usage.total_tokens사용된 총 토큰 수 (과금 기준)
  • finish_reason생성 종료 사유. "stop"은 정상 완료를 의미합니다.
4

SDK 설치 (선택)

빌링AI는 OpenAI 호환 API를 제공하므로, 기존 OpenAI SDK를 그대로 사용할 수 있습니다. Base URL만 변경하면 됩니다.

JavaScript / TypeScript

npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://api.billing-ai.kr/api/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5-4",
  messages: [{ role: "user", content: "안녕하세요!" }],
});

console.log(response.choices[0].message.content);

Python

pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.billing-ai.kr/api/v1",
)

response = client.chat.completions.create(
    model="gpt-5-4",
    messages=[{"role": "user", "content": "안녕하세요!"}],
)

print(response.choices[0].message.content)

다음 단계