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

# Python SDK

> 从安装依赖到运行完整的文本对话示例。

## 准备环境变量

macOS / Linux 终端示例：

```bash theme={null}
export API_KEY='YOUR_API_KEY'
export MODEL='YOUR_MODEL_ID'
```

## 安装

```bash theme={null}
python -m pip install openai
```

## 完整示例

保存为 `example.py`，执行 `python example.py`。

```python theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["API_KEY"],
    base_url="https://token.poryf.com/v1",
)
response = client.chat.completions.create(
    model=os.environ["MODEL"],
    messages=[{"role": "user", "content": "你好，请用一句话介绍自己。"}],
)
print(response.choices[0].message.content)
```

## 接入后检查

终端打印模型回答后，到 [使用日志](https://token.poryf.com/usage-logs/common) 核对请求。报错时先检查环境变量是否在运行程序的同一终端中设置。

密钥只用于服务端。示例未执行付费调用；实际可用模型以你的密钥权限为准。

下一步：[流式输出](/streaming) · [错误排查](/errors)。