API 快速开始
Base URL
所有 API 请求的 base URL 为:
https://api.123.com/v1
鉴权方式
所有请求需要在 HTTP 头中携带 API Key:
Authorization: Bearer sk-xxxxxxxxxxxx
在「控制台 → API Key」页面创建令牌后,会显示完整的 Key(仅显示一次,请妥善保存)。
第一个请求
curl
curl https://api.123.com/v1/chat/completions \
-H "Authorization: Bearer sk-xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "你好"}
]
}'
Python
import requests
resp = requests.post(
"https://api.123.com/v1/chat/completions",
headers={
"Authorization": "Bearer sk-xxxx",
"Content-Type": "application/json",
},
json={
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "你好"}
],
},
)
print(resp.json())
OpenAI SDK(Python)
平台 API 兼容 OpenAI SDK,只需修改 base_url:
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxx",
base_url="https://api.123.com/v1",
)
resp = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
OpenAI SDK(Node.js)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-xxxx",
baseURL: "https://api.123.com/v1",
});
const resp = await client.chat.completions.create({
model: "gpt-4o",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
支持的接口
| 接口 | 路径 | 说明 |
|---|---|---|
| 对话补全 | POST /v1/chat/completions | 文本对话 |
| 文本嵌入 | POST /v1/embeddings | 向量嵌入 |
| 图片生成 | POST /v1/images/generations | 同步图片 |
| 异步图片 | POST /v1/images/async | 大图异步生成 |
| 模型列表 | GET /v1/models | 可用模型 |
额度说明
- 每个令牌有独立的额度上限
- 调用 API 时按模型定价扣除额度
- 在「控制台 → API Key」可查看剩余额度
下一步
- 异步图片生成 — 大图异步生成接口
- API Key 管理 — 令牌管理