用户指南
使用 API
通过兼容接口和 SDK 调用 词远 模型。
将平台地址替换 OpenAI 的 base_url，使用平台颁发的密钥作为 api_key，即可开始调用。
游乐场在线测试
游乐场是内置的在线测试工具，无需编写代码即可直接与模型对话，适合快速验证密钥是否可用。
访问游乐场
点击左侧导航的「游乐场」，或直接访问 /playground。
使用游乐场
- 在左侧选择要测试的模型。
- 在底部输入框输入消息内容，点击发送。
- 右侧对话区域会显示模型的回复结果。
截图中只展示输入前的演示状态，避免在文档制作时触发真实模型调用。
获取 API 地址
复制 API 地址
- 访问平台首页。
- 在页面中部找到 API Base URL 显示区域。
- 点击复制按钮，将地址复制到剪贴板。
配置客户端
平台 API Base URL 为 https://api.tokenformation.com/。在 OpenAI SDK 等兼容客户端中，通常需要填写带版本路径的 https://api.tokenformation.com/v1 作为 base_url，配合密钥即可开始调用。
代码示例
Python（OpenAI SDK）
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxxxxxxxxxxxxx", # 平台颁发的密钥
base_url="https://api.tokenformation.com/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)
Claude 原生格式
curl https://api.tokenformation.com/v1/messages \
-H "x-api-key: sk-xxxxxxxx" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "claude-3-5-sonnet-20241022", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'
Gemini 原生格式
curl "https://api.tokenformation.com/v1beta/models/gemini-1.5-pro:generateContent?key=sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"contents": [{"parts": [{"text": "Hello"}]}]}'
支持的接口端点
| 接口 | 路径 | 说明 |
|---|---|---|
| 聊天补全 | POST /v1/chat/completions | 对话生成，支持流式输出。 |
| 文本补全 | POST /v1/completions | 传统补全接口。 |
| 向量嵌入 | POST /v1/embeddings | 文本向量化。 |
| 图像生成 | POST /v1/images/generations | 文生图。 |
| 图像编辑 | POST /v1/images/edits | 图像编辑。 |
| 语音转文字 | POST /v1/audio/transcriptions | Whisper 等语音转文字能力。 |
| 文字转语音 | POST /v1/audio/speech | TTS 文字转语音能力。 |
| 重排序 | POST /v1/rerank | 文档重排序。 |
| Responses API | POST /v1/responses | OpenAI Responses 格式。 |
| 实时对话 | GET /v1/realtime（WebSocket） | OpenAI Realtime API。 |
| 模型列表 | GET /v1/models | 查询可用模型。 |