原生 API 调用(代码直连)
本页中的
{baseUrl}是平台 API 根地址(不含末尾/或/v1),使用前请替换为实际地址。模型、价格和界面以当前控制台及客户端版本为准。
Python(OpenAI SDK)
pip install openai
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="{baseUrl}/v1",
)
resp = client.chat.completions.create(
model="gpt-5.2",
messages=[
{"role": "system", "content": "你是一个简洁的助手。"},
{"role": "user", "content": "用一句话解释什么是智能路由。"},
],
)
print(resp.choices[0].message.content)
流式输出
stream = client.chat.completions.create(
model="gpt-5.2",
messages=[{"role": "user", "content": "写一首关于树的四行诗"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Node.js(openai 包)
npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的密钥",
baseURL: "{baseUrl}/v1",
});
const resp = await client.chat.completions.create({
model: "gpt-5.2",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
Anthropic SDK
pip install anthropic
from anthropic import Anthropic
client = Anthropic(
api_key="sk-你的密钥",
base_url="{baseUrl}", # 不要带 /v1
)
msg = client.messages.create(
model="claude-sonnet-4-5-20250929",
max_tokens=1024,
messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)
Google GenAI SDK(Gemini 原生)
pip install google-genai
from google import genai
client = genai.Client(
api_key="sk-你的密钥",
http_options={"base_url": "{baseUrl}"},
)
resp = client.models.generate_content(
model="gemini-2.5-pro",
contents="你好",
)
print(resp.text)
图像与视频生成
图像生成(OpenAI 兼容图像端点):
from openai import OpenAI
client = OpenAI(api_key="sk-你的密钥", base_url="{baseUrl}/v1")
resp = client.images.generate(
model="gemini-3-pro-image",
prompt="一只站在雪地里的红狐狸,写实风格",
size="1024x1024",
)
print(resp.data[0].url)
视频生成属于异步任务:提交任务拿到 task_id,再轮询查询结果。平台提供统一的视频生成端点与任务查询端点,以及各厂商专用端点(Kling / Sora / 即梦 / 火山引擎)。具体参数请参考视频生成接口。
MiniMax H3/H3-Max、H3 2K 升级和 Context-IR 使用独立的 /v2 原生异步接口,请参考 MiniMax H3 接入指南。创建响应中的 task_id 是平台任务 ID;视频读取 task.content.url,Context-IR 读取 task.content.prompt。
常用端点速查
| 端点 | 方法 | 说明 |
|---|---|---|
/v1/models | GET | 列出可用模型 |
/v1/chat/completions | POST | 对话补全 |
/v1/responses | POST | Responses API |
/v1/messages | POST | Anthropic 原生对话 |
/v1/embeddings | POST | 文本嵌入 |
/v1/audio/speech | POST | 文本转语音 |
/v2/video_generation | POST | MiniMax H3/H3-Max 视频生成 |
/v2/video_regeneration | POST | H3 2K 升级 |
/v2/h3_context_ir | POST | Context-IR 提示词生成 |
/v2/query/video_generation/{task_id} | GET | 查询 MiniMax H3 系列任务 |
/v1beta/models | GET | Gemini 原生模型列表 |
/api/user/self | GET | 查询账户信息(需访问令牌) |
/api/log/self | GET | 查询调用日志(需访问令牌) |