文档 · 入门
快速开始
三步发出第一个请求:获取接入地址与 API Key、安装 SDK、调用模型。
1. 获取接入地址与 API Key
登录控制台创建 API Key,并复制控制台中显示的接入地址(Base URL)。
Base URL
https://<your-endpoint>/v1
登录控制台后可见
API Key
YOUR_API_KEY
在控制台创建
接入地址只在控制台中提供。文档中的
https://<your-endpoint> 均为占位,请替换成控制台里的地址。2. 安装 SDK
pip install --upgrade openai3. 配置环境变量
OpenAI 官方 SDK 会自动读取 OPENAI_BASE_URL 和 OPENAI_API_KEY,代码里无需写死地址和密钥。
# Find your endpoint and API key in the console
export OPENAI_BASE_URL="https://<your-endpoint>/v1"
export OPENAI_API_KEY="YOUR_API_KEY"4. 发送第一个请求
curl https://<your-endpoint>/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4.1-mini",
"messages": [{"role": "user", "content": "Hello!"}]
}'返回结构与 OpenAI 完全一致。接下来可以阅读:
- 对话补全:多轮对话、常用参数与响应结构
- 流式输出:边生成边返回,降低首字延迟
- Anthropic 格式:用 Anthropic SDK 调用 Claude
- 最佳实践:重试、超时、并发与成本控制