빌링AI빌링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://billing-ai.doublezero.kr/api/v1/chat/completions \
  -H "Authorization: Bearer sk-proj-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-6-sol",
    "messages": [
      {"role": "user", "content": "한국의 수도는 어디인가요?"}
    ],
    "temperature": 0.7,
    "max_tokens": 256
  }'
3

응답 확인

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

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1711234567,
  "model": "gpt-5-6-sol",
  "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

    사용된 총 토큰 수. 과금은 입력(prompt_tokens)과 출력(completion_tokens)에 각각의 단가가 적용됩니다.

    일부 장문 컨텍스트 모델은 실제 입력 토큰이 모델별 경계를 초과하면 해당 요청 전체의 입력과 출력에 장문 단가가 적용됩니다. 정확한 경계와 기본·장문 단가는 모델 상세의 단가 섹션 또는 GET /api/v1/models의 pricing.tiers에서 확인하세요.

    요청 시에는 최대 사용량 기준으로 크레딧을 임시 예약하며, 완료 후 실제 사용량과 적용 티어로 자동 정산됩니다.

  • 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://billing-ai.doublezero.kr/api/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5-6-sol",
  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://billing-ai.doublezero.kr/api/v1",
)

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

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

다음 단계