# 完成首次调用

以下示例使用 OpenAI Chat Completions 兼容接口。开始前请确认：

- 已设置 `TOKENPLAN_API_KEY` 环境变量。
- 已从模型列表取得一个支持 Chat Completions 的模型 ID。

## 使用 cURL

将示例中的模型 ID 替换为实际值：

```bash
curl https://discovery-api.intern-ai.org.cn/v1/chat/completions \
  -H "Authorization: Bearer $TOKENPLAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "【替换为正式模型 ID】",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己。"}
    ],
    "stream": false
  }'
```

## 使用 OpenAI Python SDK

安装 SDK：

```bash
pip install openai
```

运行：

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENPLAN_API_KEY"],
    base_url="https://discovery-api.intern-ai.org.cn/v1",
)

response = client.chat.completions.create(
    model="【替换为正式模型 ID】",
    messages=[
        {"role": "user", "content": "你好，请用一句话介绍你自己。"}
    ],
    stream=False,
)

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

## 确认调用成功

成功响应包含模型回复和 `usage` 用量信息：

```json
{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "你好，我是……"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 12,
    "total_tokens": 30
  }
}
```

如果调用失败，请先核对 Base URL、API Key 和模型 ID，再查看[错误码](./06-error-codes.md)。

其他接口：

- [OpenAI Chat Completions](../api-reference/03-chat-completions.md)
- [OpenAI Responses](../api-reference/04-responses.md)
- [Anthropic Messages](../api-reference/05-anthropic-messages.md)
