Chat Completions
OpenAI Chat Completions 协议。适合已有 OpenAI 兼容代码的项目;调用非 OpenAI 分组时网关自动转换协议。
POST/v1/chat/completions
请求体
modelstring必填
模型 ID,例如 gpt-5.5、claude-sonnet-4-6。
messagesobject[]必填
对话消息,role 为 system、user、assistant 或 tool。
streamboolean
为 true 时以 SSE 流式返回,以 data: [DONE] 结束。
max_completion_tokensinteger
最大输出 Token 数。
toolsobject[]
函数工具定义,模型以 tool_calls 返回调用。
reasoning_effortstring
推理强度,支持情况取决于模型。
temperaturenumber
采样温度。
示例
bash
curl https://api.thetaio.tech/v1/chat/completions \
-H "Authorization: Bearer $THETAIO_API_KEY" \
-H "content-type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [
{"role": "system", "content": "你是一名简洁的助手。"},
{"role": "user", "content": "列出三种排序算法"}
]
}'python
from openai import OpenAI
client = OpenAI(base_url="https://api.thetaio.tech/v1", api_key="sk-...")
completion = client.chat.completions.create(
model="gpt-5.5",
messages=[{"role": "user", "content": "列出三种排序算法"}],
)
print(completion.choices[0].message.content)响应
json
{
"id": "chatcmpl-...",
"object": "chat.completion",
"model": "gpt-5.5",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "快速排序、归并排序、堆排序。" },
"finish_reason": "stop"
}
],
"usage": { "prompt_tokens": 24, "completion_tokens": 15, "total_tokens": 39 }
}Embeddings
POST/v1/embeddings
仅 OpenAI 分组可用,请求与响应格式同 OpenAI 官方 Embeddings 接口。
bash
curl https://api.thetaio.tech/v1/embeddings \
-H "Authorization: Bearer $THETAIO_API_KEY" \
-H "content-type: application/json" \
-d '{"model": "text-embedding-3-small", "input": "ThetaIO"}'