快速开始
三步发出第一个请求:拿密钥、定基址、发请求 —— 附 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;异步任务的通用规则见异步任务。