快速上手

5 分钟完成 Tokaify API 首次接入：登录、选模型、创建令牌、Playground 调试与 API 调用

先记住这 4 个值

控制台入口：登录 Tokaify 后先看数据看板
OpenAI 兼容 Base URL：https://api.tokaify.com/v1（官方 API 示例；自部署请替换为你的域名）
API Key：在令牌管理创建的完整 sk-...
Model：在模型广场或 /v1/models 返回结果中复制可用模型 ID

Tokaify API 是统一的 AI 网关与资产管理平台，支持 OpenAI 兼容调用、多模型接入、令牌权限控制、余额管理和请求级用量审计。下面这套流程参考了通用 MaaS 平台的 quickstart 结构，并按 Tokaify 的实际功能做了落地化整理。

1. 登录平台

当前余额是否足够
API 地址 是否可以直接复制
今日消耗、RPM、TPM 是否正常
平台公告、维护通知和常用入口是否有需要关注的说明

如果你是第一次接入，建议把数据看板和钱包页一起看一遍，先确认账户状态，再开始调试。

2. 查看模型列表和模型详情

进入模型广场查看当前账号可用的模型、价格和能力标签。

建议按下面顺序筛选：

先按任务类型筛选，例如文本、视觉、多模态、图像或视频。
再对比价格、上下文长度和能力标签。
最后复制标准模型标识，作为代码里的 model 参数。

如果你准备接入生产业务，建议不要手填模型名，直接从模型详情或接口返回结果里复制。

3. 在 Playground 体验 GenAI 能力

进入Playground 调试台后，可以先不写代码，直接在线验证模型效果。

选择分组和模型，确认当前账号确实可以调用
输入提示词或多轮消息，测试输出质量
调整 temperature 等参数，验证你需要的生成风格
查看预览请求体、实际请求体和响应内容，确认请求格式是否符合预期

建议

先在 Playground 跑通一次，再把同样的模型名和参数搬到代码里，排错成本会低很多。

4. 创建 API Key

进入令牌管理页面，点击“添加令牌”创建你的业务凭证。

创建时建议至少配置好这几项：

令牌名称：按项目或环境命名，例如 web-prod、agent-test
分组：按页面可选项选择实际业务分组
模型限制：只放开当前业务需要的模型
额度 / 过期时间 / IP 限制：按风险等级补齐

创建完成后，请复制完整密钥。接入时直接使用完整 sk-...，不要手动删前缀。

5. 使用 Tokaify API 发起第一次调用

5.1 先验证模型列表

curl https://api.tokaify.com/v1/models \
  -H "Authorization: Bearer sk-your-token"

如果这里能正常返回模型列表，说明 Base URL 和 API Key 都已经可用。

5.2 通过 REST 接口调用聊天模型

curl https://api.tokaify.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "请用一句话介绍 Tokaify API。"
      }
    ]
  }'

5.3 通过 OpenAI SDK 调用

先安装官方 Python SDK：

pip install --upgrade openai

然后将 base_url 指向 Tokaify 的 OpenAI 兼容地址：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-token",
    base_url="https://api.tokaify.com/v1",
)

response = client.chat.completions.create(
    model="your-model-id",
    messages=[
        {
            "role": "user",
            "content": "请用一句话介绍 Tokaify API。"
        }
    ],
)

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