API 레퍼런스

OpenAI Chat Completions API 사용

BetterToken의 OpenAI 호환 Chat Completions API를 사용하세요. 요청 URL, Bearer API Key, curl, Python, JavaScript 예제를 보세요.

POST https://bettertoken.ai/v1/chat/completions로 OpenAI-compatible Chat Completions를 호출하세요. 대부분의 external tools는 Base URL https://bettertoken.ai/v1을 사용하고 /chat/completions를 자체적으로 추가합니다.

주요 설정

필드	값
API Key	BetterToken API Key
Full request URL	`https://bettertoken.ai/v1/chat/completions`
Model	`YOUR_MODEL_ID`

사전 요구 사항

BetterToken API Key 만들기
모델 광장 또는 key Setup dialog에서 Model ID 복사
curl 또는 Python 3 / Node.js가 있는 terminal 준비

설치

curl

curl에는 SDK가 필요하지 않습니다. terminal에서 curl --version이 작동하는지 확인하세요.

Python

python -m pip install openai

JavaScript

npm install openai

수동 설정

curl

curl "https://bettertoken.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "Hello"
      }
    ]
  }'

Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://bettertoken.ai/v1",
)

response = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[
        {"role": "user", "content": "Hello"},
    ],
)

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

JavaScript SDK

import OpenAI from "openai";

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

const response = await client.chat.completions.create({
  model: "YOUR_MODEL_ID",
  messages: [{ role: "user", content: "Hello" }],
});

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

연결 확인

오른쪽 Playground에서 다음을 수행하세요.

Authorization 아래에 YOUR_API_KEY를 입력하세요.
model을 YOUR_MODEL_ID로 바꾸세요.
messages를 수정하고 request를 보내세요.

Playground는 이미 전체 URL https://bettertoken.ai/v1/chat/completions을 사용합니다.

200 response에 choices[0].message.content의 model output이 포함되면 연결이 확인됩니다.

모델 전환

YOUR_MODEL_ID를 모델 광장 또는 Setup dialog의 전체 Model ID로 바꾸세요. display name을 기준으로 Model ID를 줄이지 마세요.

자주 발생하는 오류

오류	해결 방법
`401`	`Authorization: Bearer YOUR_API_KEY`를 확인한 다음 BetterToken API Key를 다시 복사하세요.
`404`	direct HTTP calls는 `https://bettertoken.ai/v1/chat/completions`을 사용하며 SDK `base_url`은 `https://bettertoken.ai/v1`을 사용합니다.
Model not found	모델 광장 또는 Setup dialog의 전체 Model ID를 사용하세요.
Invalid request	`messages`가 array이고 모든 item에 `role`과 `content`가 있는지 확인하세요.

기술 세부 정보

Base URL 및 전체 request URL

GitHub Copilot 및 TRAE처럼 전체 request URL이 필요한 tools는 https://bettertoken.ai/v1/chat/completions을 사용합니다. Cursor, Cline, OpenCode, n8n 및 Dify처럼 path를 자체적으로 추가하는 tools는 https://bettertoken.ai/v1만 사용합니다.

POST/v1/chat/completions

인증

Authorizationstringheader필수

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

본문 application/json

modelstring필수

A model ID currently available in the model plaza. Check the model plaza for the latest options.

예제:"YOUR_MODEL_ID"

messagesobject[]필수

Conversation messages. Each item should contain role and content.

Minimum array length: 1

Show child attributes

messages[].rolestring필수

예제:"user"

messages[].contentstring필수

예제:"Hello"

streamboolean기본값: false

Whether to request a streaming response.

응답

200The Chat Completions result from the selected model.

400Invalid request format or parameters.

401The BetterToken API Key is missing or invalid.

402The account has insufficient credit or balance.

429The request exceeded a rate or concurrency limit, or the upstream service is busy.

500The gateway or upstream service returned an error.

curl 'https://bettertoken.ai/v1/chat/completions' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ --data '{ "model": "YOUR_MODEL_ID", "messages": [{"role": "user", "content": "Hello"}] }'

import requests url = "https://bettertoken.ai/v1/chat/completions" payload = { "model": "YOUR_MODEL_ID", "messages": [ { "role": "user", "content": "Hello" } ] } headers = { "Authorization": "Bearer <token>", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)

const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: JSON.stringify({model: 'YOUR_MODEL_ID', messages: [{role: 'user', content: 'Hello'}]}) }; fetch('https://bettertoken.ai/v1/chat/completions', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err));

<?php $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://bettertoken.ai/v1/chat/completions", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => json_encode([ 'model' => 'YOUR_MODEL_ID', 'messages' => [ [ 'role' => 'user', 'content' => 'Hello' ] ] ]), CURLOPT_HTTPHEADER => [ "Authorization: Bearer <token>", "Content-Type: application/json" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; }

package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://bettertoken.ai/v1/chat/completions" payload := strings.NewReader("{\n \"model\": \"YOUR_MODEL_ID\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Hello\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer <token>") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) }

HttpResponse<String> response = Unirest.post("https://bettertoken.ai/v1/chat/completions") .header("Authorization", "Bearer <token>") .header("Content-Type", "application/json") .body("{\n \"model\": \"YOUR_MODEL_ID\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Hello\"\n }\n ]\n}") .asString();

require 'uri' require 'net/http' url = URI("https://bettertoken.ai/v1/chat/completions") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer <token>' request["Content-Type"] = 'application/json' request.body = "{\n \"model\": \"YOUR_MODEL_ID\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Hello\"\n }\n ]\n}" response = http.request(request) puts response.read_body