API 调用示例

下面用最小文本请求验证接入。示例中的 glm-5.2 来自原教程，请替换为你的 Key 可用的模型。请求成功取决于对应模型、分组和协议支持情况。

准备环境变量

在本机终端设置密钥，后面的命令从环境变量读取。这里的 sk-your-api-key 是占位符。

macOS / LinuxWindows PowerShell

export ONEMODEL_API_KEY="sk-your-api-key"

powershell

$env:ONEMODEL_API_KEY = "sk-your-api-key"

OpenAI Chat Completions

适合使用 OpenAI 兼容聊天接口的程序。完整请求地址为 /v1/chat/completions。

cURL · macOS / LinuxWindows PowerShellPython · 标准库

curl https://one-model.com/v1/chat/completions \
  -H "Authorization: Bearer $ONEMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.2",
    "messages": [{"role": "user", "content": "你好"}]
  }'

powershell

$headers = @{ Authorization = "Bearer $env:ONEMODEL_API_KEY" }
$body = @{
  model = "glm-5.2"
  messages = @(@{ role = "user"; content = "你好" })
} | ConvertTo-Json -Depth 10

$result = Invoke-RestMethod `
  -Uri "https://one-model.com/v1/chat/completions" `
  -Method Post `
  -Headers $headers `
  -ContentType "application/json; charset=utf-8" `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($body))

$result.choices[0].message.content

python

import json
import os
import urllib.request

payload = {
    "model": "glm-5.2",
    "messages": [{"role": "user", "content": "你好"}],
}
request = urllib.request.Request(
    "https://one-model.com/v1/chat/completions",
    data=json.dumps(payload).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {os.environ['ONEMODEL_API_KEY']}",
        "Content-Type": "application/json",
    },
    method="POST",
)
with urllib.request.urlopen(request, timeout=120) as response:
    result = json.load(response)
    print(result["choices"][0]["message"]["content"])

OpenAI Responses

Codex 使用该协议。以下为最小 HTTP 示例，工具调用等高级能力需要模型和上游共同支持。

curl https://one-model.com/v1/responses \
  -H "Authorization: Bearer $ONEMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.2",
    "input": "你好"
  }'

响应内容位于 output 中，不要按 Chat Completions 的 choices 结构解析。接口结构参见 OpenAI Responses 文档。

Anthropic Messages

Claude Code 使用 Anthropic 兼容接口。直接发起 HTTP 请求时填完整路径 /v1/messages。

curl https://one-model.com/v1/messages \
  -H "x-api-key: $ONEMODEL_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.2",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

Messages 的文本内容在 content 数组中，请求字段参见 Anthropic Messages 文档。该示例用于验证文本调用，具体模型的工具调用、思考和图片能力请以平台实际支持情况为准。

查看可用模型

curl https://one-model.com/v1/models \
  -H "Authorization: Bearer $ONEMODEL_API_KEY"

如果客户端不能自动拉取列表，可从模型页面复制 ID，并确认 Key 分组。列表中出现模型并不等于该模型支持每一种协议或高级功能。

调用后检查

查看 HTTP 状态和返回体，确认收到正常的模型输出。
在用量页面核对实际调用记录。
若失败，查看常见问题，不要反复使用错误的地址或占位密钥重试。

示例范围

这些示例用于说明请求格式；文档构建不会发送带真实密钥的请求，也不会验证账户当前余额或模型可用性。完整认证、流式输出和错误处理应按应用需求补充。

API 调用示例 ​

准备环境变量 ​

OpenAI Chat Completions ​

OpenAI Responses ​

Anthropic Messages ​

查看可用模型 ​