> ## 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.
# 快速开始
> 从创建密钥到收到第一条模型回答。
本站 API 地址为 `https://token.poryf.com/v1`。使用未来模力创建的密钥，不需要向客户端提供 DeepSeek、GLM 或 Kimi 的官方密钥。
## 第一步：获取 API 密钥
1. 登录 [API 密钥管理](https://token.poryf.com/keys)，创建一个用于本次接入的密钥。
2. 设置名称、可用分组、有效期与额度，保存后复制密钥。
3. 到 [钱包](https://token.poryf.com/wallet) 确认账户余额。字段填写方法见 [API 密钥管理指南](/account/api-keys)。
密钥等同于调用凭证。只放在服务端或可信客户端，不要写入公开仓库、网页代码或截图。
## 第二步：选择模型
在 [钱包](https://token.poryf.com/wallet) 确认余额，然后在 [模型广场](https://token.poryf.com/pricing) 查看模型 ID 和当前价格。也可以用 [模型列表接口](/api/list-models) 查询该密钥可见的模型。
| 模型系列 | 从哪里选择 | 接入方式 |
| -------- | ------------------ | ------------- |
| DeepSeek | 模型广场中的 DeepSeek 型号 | OpenAI 兼容文本对话 |
| GLM | 模型广场中的 GLM 型号 | OpenAI 兼容文本对话 |
| Kimi | 模型广场中的 Kimi 型号 | OpenAI 兼容文本对话 |
复制精确的模型 ID；品牌名称与展示标题不能代替 API 的 `model` 字段。实际可用型号以密钥返回的模型列表为准，具体能力因型号而异。
## 第三步：发送请求
把 `YOUR_API_KEY` 替换为本站密钥，把 `YOUR_MODEL_ID` 替换为第二步复制的型号。在 macOS / Linux 终端执行下面的请求。调用会产生实际用量。
不写代码也可以使用：[Cherry Studio](/integrations/cherry-studio) 或 [Chatbox](/integrations/chatbox)。
```bash theme={null}
curl --request POST 'https://token.poryf.com/v1/chat/completions' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "YOUR_MODEL_ID",
"messages": [
{"role": "user", "content": "你好，请用一句话介绍自己。"}
]
}'
```
SDK 用户可以直接查看 [Python / JavaScript 示例](/sdk)。
## 第四步：查看结果
成功响应中的 `choices[0].message.content` 是模型回答。以下为结构示意，并非真实调用记录；模型名称、回答和用量以实际响应为准。
```json theme={null}
{
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "你好，我是你的 AI 助手。" },
"finish_reason": "stop"
}
]
}
```
在 [使用日志](https://token.poryf.com/usage-logs/common) 查看请求记录与扣费。若返回 `error`，按 [常见错误](/errors) 排查，不要只依据 HTTP 状态判断回答是否成功。
## 下一步
了解 Base URL、鉴权和 /v1 的填写方式。
在聊天客户端中填写地址、密钥和模型。
安装 SDK 并运行第一次调用。
使用流式输出读取模型回答。
以模型广场的实时信息选择模型。