Skip to content
文本生成

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"}'