文档目录

快速开始

三步发出第一个请求:拿密钥、定基址、发请求 —— 附 curl / Python / Node 示例。

内容最后核对:2026-11-18

本页目录

三步

一、拿密钥。 控制台 →「API 密钥」→ 新建。明文只显示这一次;之后只保存摘要,丢了只能重新签发。

二、确定基址。 永远是 <网关地址>/v1。两个常见写错:写成 /api/v1(那是控制台命名空间,会 401 且不进使用日志),或者把整条 /v1/chat/completions 当 base 填进 SDK。准确值在控制台「连接信息」或 GET /api/meta 的 api_base_url。

三、发一个请求。

KEY="sk-ag-..."                 # 第一步签发的密钥
BASE="<网关地址>/v1"            # 注意结尾是 /v1,不是 /api/v1

curl -s "$BASE/chat/completions" \
  -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"<模型名>","messages":[{"role":"user","content":"你好"}]}'

Python 用 OpenAI 官方 SDK,只改 base_url:

from openai import OpenAI

client = OpenAI(api_key="sk-ag-...", base_url="<网关地址>/v1")
reply = client.chat.completions.create(
    model="<模型名>",
    messages=[{"role": "user", "content": "你好"}],
)
print(reply.choices[0].message.content)

Node 同理:

import OpenAI from 'openai';

const client = new OpenAI({ apiKey: 'sk-ag-...', baseURL: '<网关地址>/v1' });
const reply = await client.chat.completions.create({
  model: '<模型名>',
  messages: [{ role: 'user', content: '你好' }],
});

模型名先查清单

GET /v1/models 列的是本站实际接入的模型,不是厂商的全量目录。模型名有两种写法(显示名与规范 id),解析顺序见模型与路由。

「同一个模型名在别家能用、这里 404」几乎都是这个原因,不是故障。

出图、出音、出视频

# 图像(同步)
client.images.generate(model="<图像模型>", prompt="一只橘猫", n=1)

# 语音(返回字节)
speech = client.audio.speech.create(model="<TTS 模型>", voice="alloy", input="你好")

# 视频(异步;提交后轮询)
job = client.videos.create(model="<视频模型>", prompt="一只橘猫在窗台上", seconds="5")

视频还有另外三种官方格式(可灵 / 即梦 / 通用),字段见视频 API;异步任务的通用规则见异步任务。

下一步

要做的事看这篇
换一个 SDK(Anthropic / Gemini / 方舟 / 百炼)用官方 SDK
接流式输出流式输出
处理超时与重试超时、重试与幂等
算清楚一次调用多少钱计费与配额
从别家迁过来从别的网关迁移