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

# Opik

> Opik을 사용하여 TokenLab의 OpenAI 호환 요청 추적하기

## 개요

Opik은 TokenLab의 OpenAI 호환 엔드포인트를 가리키는 OpenAI 클라이언트를 래핑하여 TokenLab 호출을 로깅할 수 있습니다.

<Note>
  **유형**: 관측 가능성(Observability)

  **기본 경로**: OpenAI SDK 추적 래퍼

  **지원 신뢰도**: 지원되는 OpenAI 호환 추적 경로
</Note>

## 설치

```bash theme={null}
pip install opik openai
```

## 환경 설정

```bash theme={null}
export TOKENLAB_API_KEY="sk-your-tokenlab-key"
export OPIK_PROJECT_NAME="tokenlab-integration-demo"
```

## OpenAI 클라이언트 래핑

```python theme={null}
import os

from openai import OpenAI
from opik.integrations.openai import track_openai

client = OpenAI(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh/v1",
)

openai_client = track_openai(client)
```

## 채팅 완료(Chat Completion) 로깅

```python theme={null}
completion = openai_client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[
        {"role": "user", "content": "Summarize why LLM observability matters."}
    ],
)

print(completion.choices[0].message.content)
```

## 엔드포인트 참고 사항

이 설정은 OpenAI 호환 SDK 경로를 추적합니다. OpenAI SDK 외부에서 TokenLab 네이티브 엔드포인트를 사용하는 경우, 해당 클라이언트나 워크플로우를 별도로 계측하십시오.
