5 分钟完成首次调用

本指南将带您在 5 分钟内获取 API 密钥并发起第一次调用。注册与登录步骤请参阅管理台概览 → 注册账号。

本指南中的示例均基于 AI 模型接口（Chat、Embeddings、Audio 等）。完整的接口定义、请求参数与响应格式请参阅 API 参考 → AI 模型接口。

快速开始

获取 API 密钥

登录控制台后，点击左侧「API 密钥」，再点击右上角「创建密钥」。

填写密钥名称（如 my-first-key），其余选项保持默认，点击「提交」。系统将生成一个以 sk- 开头的 API 密钥，专用于调用 AI 模型接口。详细操作请参阅创建 API 密钥。

系统只会在创建时完整显示一次密钥内容，请立即复制并保存到安全的地方。

获取接口地址

平台接口完全兼容 OpenAI API 格式，只需将 Base URL 替换为本平台地址：

https://api.tokenopen.ai/v1

发起第一次请求

将下方代码中的 YOUR_API_KEY 替换为刚才创建的 API 密钥，即可运行。

curl https://api.tokenopen.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己。"
      }
    ]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.tokenopen.ai/v1",
)

response = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己。"}
    ],
)

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

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://api.tokenopen.ai/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [
    { role: "user", content: "你好，请介绍一下你自己。" }
  ],
});

console.log(response.choices[0].message.content);

package main

import (
    "context"
    "fmt"

    "github.com/openai/openai-go"
    "github.com/openai/openai-go/option"
)

func main() {
    client := openai.NewClient(
        option.WithAPIKey("YOUR_API_KEY"),
        option.WithBaseURL("https://api.tokenopen.ai/v1"),
    )

    resp, err := client.Chat.Completions.New(context.Background(), openai.ChatCompletionNewParams{
        Model: openai.F("gpt-5.4-mini"),
        Messages: openai.F([]openai.ChatCompletionMessageParamUnion{
            openai.UserMessage("你好，请介绍一下你自己。"),
        }),
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(resp.Choices[0].Message.Content)
}

接口参数说明

参数	类型	说明
`model`	string	要调用的模型名称，如 `gpt-5.4-mini`、`claude-sonnet-4-6`
`messages`	array	对话消息数组，每条消息包含 `role` 和 `content`
`temperature`	number	可选，控制输出随机性，范围 0–2，默认 1
`max_tokens`	integer	可选，限制输出最大 token 数量
`stream`	boolean	可选，设为 `true` 开启流式输出

流式输出示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.tokenopen.ai/v1",
)

stream = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "写一首关于春天的短诗。"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="", flush=True)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://api.tokenopen.ai/v1",
});

const stream = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [{ role: "user", content: "写一首关于春天的短诗。" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

常用模型名称

模型	名称
GPT-5.5	`gpt-5.5`
GPT-5.4	`gpt-5.4`
GPT-5.4-mini	`gpt-5.4-mini`
GPT-5.4-nano	`gpt-5.4-nano`
Claude Opus 4.7	`claude-opus-4-7`
Claude Sonnet 4.6	`claude-sonnet-4-6`
Gemini 3.5 Flash	`gemini-3.5-flash`
Gemini 3.1 Pro	`gemini-3.1-pro-preview`
DeepSeek-V4 Pro	`deepseek-v4-pro`
Qwen3-235B	`qwen3-235b-a22b`

完整的模型列表和实时价格，请前往平台「定价」页面查看。

错误排查

错误码	原因	解决方法
`401 Unauthorized`	API Key 无效或格式错误	检查密钥是否完整，前缀为 `sk-`
`403 Forbidden`	当前分组无权访问该模型	更换模型或联系客服升级分组
`429 Too Many Requests`	超出速率限制	降低请求频率或申请提升分组
`402 Payment Required`	账户余额不足	前往钱包页面充值
`500 Internal Server Error`	上游服务暂时不可用	稍后重试或切换其他模型

从 OpenAI 迁移

本平台完全兼容 OpenAI API 协议，迁移只需两步，无需修改任何业务逻辑代码。

第一步：替换 Base URL

将代码或配置中的官方地址 https://api.openai.com 替换为 https://api.tokenopen.ai。

第二步：替换 API Key

将 OpenAI 的 sk- 开头密钥替换为在本平台控制台创建的 API 密钥。

原变量	新展
`OPENAI_API_KEY`	本平台 API 密钥（`sk-` 开头）
`OPENAI_BASE_URL`	`https://api.tokenopen.ai/v1`
`ANTHROPIC_BASE_URL`	`https://api.tokenopen.ai`

完成以上两步后，您的程序将直接通过本平台调用 AI 模型，无需其他任何改动。

查看调用结果

发起调用后，可在控制台「日志」页面实时查看每次请求的详细记录。

字段	说明
调用时间	请求发起的时间戳
模型	本次调用使用的模型名称
密钥名	使用的 API 密钥名称
输入 Token	请求消耗的输入 Token 数
输出 Token	响应生成的输出 Token 数
消耗颗度	本次调用扣除的积分数
状态	成功 / 失败 / 超时

如需查看按天或按模型汇总的用量趋势，请前往控制台「数据看板」页面。

5 分钟完成首次调用

目录