API 文档与接入指南
从注册接入到正式调用的完整说明，助您快速集成全球主流 AI 大模型。
欢迎使用我们的 API 文档。本文档将帮助您快速了解和使用我们的服务接口。
快速开始
(1) 注册账号
点击页面右上角「登录」按钮，选择「注册」标签页，填写邮箱地址并设置密码。注册完成后即可登录平台。
注册步骤：
- 访问平台首页，点击右上角「登录」
- 切换到「注册」标签页
- 填写邮箱、密码、企业名称（可选）
- 点击「立即创建账号」完成注册
(2) 登录账号
使用注册时的邮箱和密码登录。登录后可进入用户中心查看 API Key、账户余额和调用记录。
(3) 充值额度
平台采用预付费模式，按实际调用量计费。进入用户中心「充值」标签页，选择充值金额和支付方式（支付宝/微信），完成支付后余额即时到账。
(4) 获取 API Key
注册成功后，需要手动创建 API Key。登录后进入用户中心，在左侧菜单找到「API 密钥」标签页，点击「创建新密钥」按钮，输入密钥名称（可选），点击确认即可生成。请妥善保管，勿泄露给他人。
✓ 手动创建 API Key，格式：ak_xxxxxxxxx_xxxxxxxx
创建步骤：
- 登录后进入用户中心（Dashboard）
- 在左侧菜单找到「API 密钥」标签页
- 点击「创建新密钥」按钮
- 输入密钥名称（可选），点击确认
- 复制并妥善保管生成的 API Key
// 在请求头中使用 API Key
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}(5) 配置 CLI 工具
获取 API Key 后，可配置 Codex、Claude Code、Gemini CLI 等工具直接调用平台模型。详见下方 CLI 配置教程。
模型分组介绍
模型广场
令牌分组介绍
不同模型按能力分组：文本对话、图像生成、语音合成、多模态等。每个分组有独立的定价策略。
CLI 配置教程
Node.js 环境安装教程
# 安装 Node.js (推荐 v18+)
npm install -g node
# 创建项目
mkdir my-ai-app && cd my-ai-app
npm init -y
npm install openaiCodex 配置
# 设置 API 基础 URL
export OPENAI_BASE_URL=https://api.zhiaitech.com/v1
export OPENAI_API_KEY=your_api_key_here
# 使用 Codex
codex "解释这段代码"}Claude Code 配置
# 设置环境变量
export ANTHROPIC_BASE_URL=https://api.zhiaitech.com/v1
export ANTHROPIC_API_KEY=your_api_key_here
# 使用 Claude Code
claude "帮我写一个排序算法"}Gemini CLI 配置
# 设置 Gemini CLI
export GEMINI_API_KEY=your_api_key_here
export GEMINI_BASE_URL=https://api.zhiaitech.com/v1
# 使用 Gemini
gemini "生成一首诗"}Grok Build 配置
# Grok Build 配置
export GROK_API_KEY=your_api_key_here
export GROK_BASE_URL=https://api.zhiaitech.com/v1
# 使用 Grok
grok "分析这段数据"}多语言官方 SDK
我们提供 Python、JavaScript/TypeScript、Go、Java 四种官方维护的 SDK，内置重试、超时、错误处理逻辑，支持通过包管理器一键安装。
🐍 Python SDK
安装：
pip install aione-sdk快速开始：
from aione import AioneClient
client = AioneClient(api_key="your_api_key")
response = client.chat.completions.create(
model="qwen-plus",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)🟨 JavaScript / TypeScript SDK
安装：
npm install @aione/sdk快速开始：
import { AioneClient } from "@aione/sdk";
const client = new AioneClient({ apiKey: "your_api_key" });
const response = await client.chat.completions.create({
model: "qwen-plus",
messages: [{ role: "user", content: "Hello!" }],
});
console.log(response.choices[0].message.content);🔵 Go SDK
安装：
go get github.com/aione/aione-go快速开始：
package main
import (
"context"
"fmt"
aione "github.com/aione/aione-go"
)
func main() {
client := aione.NewClient("your_api_key")
resp, _ := client.Chat.Completions.Create(context.Background(), aione.ChatRequest{
Model: "qwen-plus",
Messages: []aione.Message{{Role: "user", Content: "Hello!"}},
})
fmt.Println(resp.Choices[0].Message.Content)
}☕ Java SDK
Maven 依赖：
<dependency>
<groupId>com.aione</groupId>
<artifactId>aione-java-sdk</artifactId>
<version>1.0.0</version>
</dependency>快速开始：
import com.aione.AioneClient;
import com.aione.model.ChatRequest;
AioneClient client = new AioneClient("your_api_key");
ChatRequest request = ChatRequest.builder()
.model("qwen-plus")
.addMessage("user", "Hello!")
.build();
var response = client.chat().completions().create(request);
System.out.println(response.getChoices().get(0).getMessage().getContent());OpenAI 迁移指南
完全兼容 OpenAI API 格式，只需替换 Base URL 即可完成迁移，无需修改业务代码：
# Python
from openai import OpenAI
client = OpenAI(
base_url="https://api.zhiaitech.com/v1",
api_key="your_api_key"
)
# JavaScript
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.zhiaitech.com/v1",
apiKey: "your_api_key",
});✓ 迁移后调用结果与原生 OpenAI SDK 行为一致，支持流式输出、Function Calling 等全部特性
进阶玩法
图片与视频
支持文生图、图生图、文生视频等多种多媒体能力。
// 图片生成示例
const response = await fetch('https://api.zhiaitech.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'wanx-v1',
prompt: '一只可爱的泰迪犬',
size: '1024x1024'
})
});AI Agent
通过 Function Calling 和工具调用，构建自主决策的 AI Agent 应用。
常见问题
注册相关
Q: 注册需要什么信息？
A: 只需邮箱地址和密码。企业名称和联系人信息为可选填写，用于企业账户认证。
Q: 注册后需要审核吗？
A: 注册即可使用，无需审核。注册完成后直接登录获取 API Key。
登录相关
Q: 忘记密码怎么办？
A: 在登录页面点击「忘记密码」，通过注册邮箱重置密码。
Q: 支持哪些登录方式？
A: 目前支持邮箱密码登录。后续将支持手机验证码和第三方登录。
获取 API Key
Q: 如何获取 API Key？
A: 登录后进入用户中心（Dashboard），在左侧菜单找到「API 密钥」标签页，点击「创建新密钥」即可生成。请妥善保管，勿泄露给他人。
Q: API Key 泄露了怎么办？
A: 立即在用户中心删除泄露的密钥，重新创建新密钥。旧密钥将立即失效。
Q: 一个账户可以创建多个 API Key 吗？
A: 可以。建议为不同应用创建独立的 API Key，便于管理和权限控制。
计费与充值
Q: 如何计费？
A: 按实际调用量计费，不同模型价格不同。文本模型按 Token 数计费，图像/视频模型按次计费。
Q: 余额不足时会怎样？
A: 余额不足时 API 调用将失败，返回 402 错误。请及时充值。
常见错误排查
Q: 返回 401 Unauthorized
A: API Key 无效或未传递。请检查请求头中 Authorization 字段格式是否正确：Bearer YOUR_API_KEY
Q: 返回 402 Payment Required
A: 账户余额不足。请前往用户中心充值。
Q: 返回 429 Too Many Requests
A: 请求频率超限。请降低调用频率或联系平台提升配额。
API 接口参考
请求端点
POST https://api.zhiaitech.com/v1/chat/completions请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称，如 qwen-plus |
| messages | array | 是 | 对话消息列表 |
| max_tokens | integer | 否 | 最大生成 token 数 |
| temperature | float | 否 | 采样温度 0-2 |
| stream | boolean | 否 | 是否流式输出 |
认证方式
// 在请求头中添加 Authorization
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}