Diese Seite ist derzeit nur auf Chinesisch verfügbar. Navigation und Menus sind bereits auf Deutsch.

快速开始

使用 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 表示限流；详见错误码。

Schnellstart · Dokumentation · InOneAPI