开始配置
打开终端安装 OpenAI Python SDK。其他语言 SDK 使用同样的 Base URL 和 API Key 配置方式。
支持的 SDK
Python · TypeScript · Java · Go · C#
推荐模型
gpt-6-astraAPI 地址
https://new.fluapi.com/v1已有 OpenAI 项目时,通常只需要替换 base_url、api_key 和 model 三项。
支持的接口
| 接口 | 端点路径 | 适用场景 |
|---|---|---|
| Chat Completions | v1/chat/completions | 已有 OpenAI ChatGPT 项目、消息数组对话 |
| Responses | v1/responses | 新项目、统一输入、需要推理参数时使用 |
如果客户端只支持传统聊天接口,使用 Chat Completions;支持 Responses 的新项目可以按 SDK 文档选择对应方法。
Python SDK
系统要求与安装
Python 3.9 或更高版本。
pip install openai
Chat Completions 示例
from openai import OpenAI
client = OpenAI(
api_key="你的 Flu API Key",
base_url="https://new.fluapi.com/v1",
)
completion = client.chat.completions.create(
model="gpt-6-astra",
messages=[
{"role": "user", "content": "Hello, GPT"},
],
max_tokens=1024,
)
print(completion.choices[0].message.content)Responses 示例
from openai import OpenAI
client = OpenAI(
api_key="你的 Flu API Key",
base_url="https://new.fluapi.com/v1",
)
response = client.responses.create(
model="gpt-6-astra",
input="用 Python 写一个 Hello World",
)
print(response.output_text)环境变量配置
推荐把地址和密钥放进环境变量,OpenAI 客户端会自动读取。
# macOS / Linux export OPENAI_API_KEY="你的 Flu API Key" export OPENAI_BASE_URL="https://new.fluapi.com/v1" # Windows PowerShell $env:OPENAI_API_KEY="你的 Flu API Key" $env:OPENAI_BASE_URL="https://new.fluapi.com/v1" # Python from openai import OpenAI client = OpenAI()
curl 直接调用
Chat Completions · 非流式
curl -X POST "https://new.fluapi.com/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 你的 Flu API Key" \
-d '{
"model": "gpt-6-astra",
"messages": [{"role": "user", "content": "你好"}],
"max_tokens": 1024
}'Responses · 非流式
curl -X POST "https://new.fluapi.com/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 你的 Flu API Key" \
-d '{
"model": "gpt-6-astra",
"input": "用 Python 写一个 Hello World",
"instructions": "你是一位编程助手。"
}'Responses · 带 Reasoning
curl -X POST "https://new.fluapi.com/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 你的 Flu API Key" \
-d '{
"model": "gpt-6-astra",
"input": "解释快速排序的时间复杂度",
"reasoning": {"effort": "high"}
}'常见错误
| 错误 | 原因 | 处理方法 |
|---|---|---|
| 401 Unauthorized | API Key 格式错误或已失效 | 重新复制 Flu API Key,并检查环境变量 |
| 模型不可用 | 模型名称不在支持列表中 | 使用 gpt-6-astra 或控制台当前支持的模型 |
| 400 field messages is required | 请求体缺少 Chat Completions 的 messages | Chat Completions 使用 messages;Responses 使用 input |
| 429 Rate limit exceeded | 请求频率过高 | 降低频率并加入重试退避 |