> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API 레퍼런스

> 클라이언트에 맞는 BetterToken API를 선택하세요. OpenAI 호환 Chat Completions·Responses와 Anthropic 호환 Messages의 연결 방법을 확인하세요.

BetterToken은 OpenAI-compatible Chat Completions 및 Responses API와 Anthropic-compatible Messages API를 제공합니다. 클라이언트에서 사용하는 API 형식을 선택하세요.

## API 선택

| API | POST | Auth |
| - | - | - |
| [Chat Completions](/ko/api-reference/chat-completions.md) | `/v1/chat/completions` | `Bearer` |
| [Responses](/ko/api-reference/responses.md) | `/v1/responses` | `Bearer` |
| [Messages](/ko/api-reference/messages.md) | `/v1/messages` | `x-api-key` |
| [Image generation](/ko/api-reference/images-generations.md) | `/v1/images/generations` | `Bearer` |
| [Image editing](/ko/api-reference/images-edits.md) | `/v1/images/edits` | `Bearer` |

## Chat Completions 연결 정보

| 필드 | 값 |
| - | - |
| Base URL | `https://bettertoken.ai/v1` |
| Full request URL | `https://bettertoken.ai/v1/chat/completions` |
| Method | `POST` |
| Authorization | `Bearer YOUR_API_KEY` |
| Model | `YOUR_MODEL_ID` |

[모델 광장](https://bettertoken.ai/pricing) 또는 콘솔의 API Key **설정** 대화 상자에서 현재 Model ID를 복사하세요.

> [!WARNING]
>
> 도구에서 **Base URL**을 요구하면 `https://bettertoken.ai/v1`을 입력하세요. 도구가 전체 요청 URL을 명시적으로 요구할 때만 `https://bettertoken.ai/v1/chat/completions`을 사용하세요.

## 빠른 테스트

```bash theme={null}
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"
      }
    ]
  }'
```

성공한 응답에는 `choices[0].message.content`가 포함됩니다.

## 대화형 테스트와 SDK 예제

[OpenAI Chat Completions API](/ko/api-reference/chat-completions.md) 페이지에서 다음 작업을 수행할 수 있습니다.

* Playground에서 요청 보내기
* 요청 매개변수와 응답 스키마 확인하기
* curl, Python, JavaScript 예제 복사하기

> [!NOTE]
>
> 실제 API Key를 문서, 스크린샷, 공개 코드에 저장하지 마세요. `YOUR_API_KEY`와 `YOUR_MODEL_ID`를 자신의 값으로 교체하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.