OpenAI Python SDK
使用 OpenAI Python SDK 调用 Sublyx 的 OpenAI compatible API。
Sublyx 兼容 OpenAI SDK 的常用调用方式。只需替换 api_key 与 base_url，其余业务代码可以继续使用熟悉的 SDK 接口。
安装
pip install openai基础调用
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("SUBLYX_API_KEY", "sk-sublyx-example"),
base_url="https://api.sublyx.org/v1",
)
response = client.chat.completions.create(
model="gpt-5.6-terra",
messages=[
{"role": "system", "content": "你是一个简洁的中文技术助手。"},
{"role": "user", "content": "解释什么是幂等请求。"},
],
)
print(response.choices[0].message.content)流式调用
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("SUBLYX_API_KEY", "sk-sublyx-example"),
base_url="https://api.sublyx.org/v1",
)
stream = client.chat.completions.create(
model="gpt-5.6-terra",
messages=[{"role": "user", "content": "写一段四行的发布说明。"}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)超时与重试
from openai import OpenAI
client = OpenAI(
api_key="sk-sublyx-example",
base_url="https://api.sublyx.org/v1",
timeout=60.0,
max_retries=2,
)生产建议
对外部请求设置总超时，并在业务层记录请求 ID、模型 ID、耗时与错误类型。不要把完整提示词或敏感响应直接写入普通日志。
异步客户端
import asyncio
from openai import AsyncOpenAI
client = AsyncOpenAI(
api_key="sk-sublyx-example",
base_url="https://api.sublyx.org/v1",
)
async def main():
response = await client.chat.completions.create(
model="gpt-5.6-terra",
messages=[{"role": "user", "content": "给出三个 API 命名建议。"}],
)
print(response.choices[0].message.content)
asyncio.run(main())