此頁面目前僅提供簡體中文版本。導覽與選單已經是繁體中文。

快速开始

使用 InOneAPI API Key 和模型详情页的公共模型 ID，先发送一个最小请求，再检查响应和用量。默认显示 cURL，也可以切换 HTTP 语言示例或使用下方 SDK。

1. 创建 API Key

在控制台 API Keys 页面创建个人 Key；团队服务可在企业协作中创建项目和团队 Key。为支持的 Key 设置模型范围、预算与速率限制。密钥可由有权限的用户查看，不是只展示一次。

将完整密钥存入服务端环境变量：

export INONEAPI_API_KEY="YOUR_INONEAPI_API_KEY"

Windows PowerShell 使用 $env:INONEAPI_API_KEY = "YOUR_INONEAPI_API_KEY"。不要把 Key 放在网页前端、公开仓库或日志中。

2. 复制模型 ID

从模型详情页复制 ID，或通过 GET /v1/models 读取当前 Key 可访问的 data[].id。将以下示例的 YOUR_MODEL_ID 替换为该完整值。

模型 ID 不要求 服务商/模型 格式。例如页面显示 deepseek-v4-flash 就填写 deepseek-v4-flash；如果目录中的 ID 本身包含 /，则原样保留。不要自行增加或删除前缀，也不要填写上游供应商内部 ID。模型详情页的示例已经代入当前模型 ID。

3. 发送 HTTP 请求

以下示例与模型详情页共用同一份生成逻辑。默认 cURL；JavaScript/TypeScript 使用 Node.js 20+，Python 使用标准库，Go 是完整 main 程序，Java 使用 Java 17+。Go/Java SDK 示例见 SDK 指南或官方依赖文档。

X-APP-NAME 和 X-APP-URL 是可选请求头，示例默认注释，不会发送占位应用名。cURL 顶部两行是可添加到命令中的参数说明，不能直接把注释插入反斜杠续行中。

# -H "X-APP-NAME: Your App Name"
# -H "X-APP-URL: https://your-app.example.com"
curl "https://api.inoneapi.com/v1/chat/completions" \
  -H "Authorization: Bearer $INONEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ]
}'

4. 或者使用官方 SDK

Node.js 安装 npm install openai；Python 安装 python -m pip install openai。SDK 的 baseURL/base_url 使用 https://api.inoneapi.com/v1。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.INONEAPI_API_KEY,
  baseURL: "https://api.inoneapi.com/v1",
  defaultHeaders: {
    // "X-APP-NAME": "Your App Name",
    // "X-APP-URL": "https://your-app.example.com",
  },
});

const response = await client.chat.completions.create({
  model: "YOUR_MODEL_ID",
  messages: [
    {
      role: "user",
      content: "Hello",
    },
  ],
});

Node.js 结果位于 response.choices[0]?.message.content；Python 位于 response.choices[0].message.content。SDK 是同一 HTTP API 的封装，不改变模型 ID 或权限。更多协议见 SDK 接入。

5. 验证与下一步

确认 HTTP 状态、返回文本和控制台用量。记录 X-Gateway-Trace-ID；cURL 可加 -i 查看响应头。模型可列出不代表支持所有协议和参数，先检查详情页能力。402 表示余额或预算等不可重试问题，429 表示限流；详见错误码。

文件 · InOneAPI