API 调用入门指南

先准备 apizt API Key，确认令牌所在分组包含 gpt-6.1-sol，再发送一条短文本请求。国内调用优先使用直连节点 https://api.apizt.com。

1. 准备 API Key 与地址

在 apizt 控制台创建令牌。分组设置见 创建分组令牌，型号与费用以 当前价格页为准。

以下终端示例使用环境变量保存当前进程读取的令牌。将占位内容换为自己的 API Key；不要把密钥提交到公开代码仓库或放入面向用户的前端代码。

export tokenba_API_KEY="替换为你的_API_Key"

2. 发送 GPT-6.1 Sol 最小 Chat 请求

三种示例发送相同的型号、消息和 reasoning_effort: low。GPT-6.1 Sol 不接受 none/minimal，Chat 请求不带 tools；需要工具调用时选择下文的 Responses 接口。

curl

curl --fail-with-body --max-time 120 'https://api.apizt.com/v1/chat/completions' \
  --header "Authorization: Bearer ${tokenba_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "model": "gpt-6.1-sol",
  "messages": [
    {
      "role": "user",
      "content": "用一句话介绍你能帮我完成什么。"
    }
  ],
  "reasoning_effort": "low"
}'

JavaScript（Node.js 20+）

使用 Node.js 内置 fetch，运行前设置相同环境变量。

async function main() {
  const apiKey = process.env.tokenba_API_KEY;
  if (!apiKey) throw new Error("请设置 tokenba_API_KEY");
  const response = await fetch("https://api.apizt.com/v1/chat/completions", {
    method: "POST",
    headers: {
      Authorization: "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "gpt-6.1-sol",
      messages: [{ role: "user", content: "用一句话介绍你能帮我完成什么。" }],
      reasoning_effort: "low"
    })
  });
  const text = await response.text();
  if (!response.ok) throw new Error("HTTP " + response.status + ": " + text);
  const result = JSON.parse(text);
  console.log(result.choices?.[0]?.message?.content ?? text);
}
main().catch(console.error);

Python（OpenAI SDK）

先执行 python3 -m pip install -U openai。SDK 使用 /v1 基址，由客户端追加 Chat 接口路径。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["tokenba_API_KEY"],
    base_url="https://api.apizt.com/v1",
)
response = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "用一句话介绍你能帮我完成什么。"}],
    reasoning_effort="low",
)
print(response.choices[0].message.content)

3. 检查响应

先检查 HTTP 状态与错误体。Chat 非流式成功响应的文本位于 choices[0].message.content；代码会打印文本，内容由实际请求决定。控制台中的本次用量和日志可用于核对型号、时间及费用。

本文提供请求模板，没有附加模型调用成功记录。需要在浏览器里修改参数并看返回，可以使用 在线调试；完整参数见 Chat 非流式补全。

4. 按任务选择协议

同一模型可能列有多个协议标记，但字段、工具与流式事件仍需按对应接口配置。选择说明见 协议对照和 聊天模型目录。

常见问题

国内调用应该填哪个地址？

国内直连节点使用 https://api.apizt.com。OpenAI SDK 的 base_url 填 https://api.apizt.com/v1；直接发送 HTTP 请求时填写完整接口，例如 https://api.apizt.com/v1/chat/completions。控制台和价格页继续使用本站给出的 .ai 链接。

API Key 如何鉴权？

HTTP 请求头为 Authorization: Bearer 你的令牌。代码示例从 tokenba_API_KEY 环境变量读取；OpenAI SDK 会自动生成鉴权请求头。在线调试输入框只填令牌本身。

GPT-6.1 Sol 可以在 Chat 中调用工具吗？

GPT-6.1 Sol 的 Chat 请求用于不带 tools 的文本或图片理解；工具调用使用 Responses。effort 接受 low、medium、high、xhigh、max，不接受 none 或 minimal。

遇到 404 或 401 怎么处理？

404 先检查路径，OpenAI SDK 的 base_url 不要填完整 /chat/completions 路径，也不要重复 /v1。401 检查 apizt 令牌、有效期及分组；模型权限与额度问题按返回错误体核对。

Chat、Responses、Claude、Gemini 只换 URL 就行吗？

需要同时调整请求字段和响应解析。Chat 使用 messages/choices；Responses 使用 input/output；Claude 原生使用 messages/max_tokens/content 块；Gemini 原生使用 contents/candidates。先按对应接口页构造最小请求。