orientxorientx

模型与参数

列出模型并了解常用的 Chat Completions 字段

GET /v1/models 列出当前密钥可调用的所有模型。 请求中的 model 必须使用返回的 id 字段,这是 API 唯一接受的模型标识。

curl https://api.orientx.ai/v1/models \
  -H "Authorization: Bearer $ORIENTX_API_KEY"
{
  "object": "list",
  "data": [
    { "id": "<MODEL_ID>", "object": "model", "owned_by": "orientx" }
  ]
}

可用模型取决于你的账户,因此应查询此接口,而不是硬编码列表。 模型下线后,请求会返回 404,错误码为 model_not_found。 快速开始提供了同一请求的 Python 和 TypeScript 示例。

如需查看各模型的 ID 和可直接复制的 API 示例,请打开模型价格页面。

请求参数

Chat Completions 接口接受标准 OpenAI 字段。以下是最常用的参数:

参数类型说明
modelstring必填。使用 GET /v1/models 返回的 id。
messagesarray必填。按顺序排列的对话轮次,包含 role 和 content。
streamboolean返回服务器发送事件,而不是一次性返回完整响应。
temperaturenumber值越高,输出越多样。默认值为 1。
top_pnumber核采样。调整此参数或 temperature,不要同时调整两者。
max_tokensinteger限制生成内容的长度,不包含提示词。
stopstring 或 array最多 4 个用于结束生成的序列。

tools、response_format 和视觉输入等可选字段的支持情况因模型而异。 模型不支持某个参数时,API 会返回 400 并指出对应字段,而不会静默忽略。

流式调用参见快速开始。 获取流式 token 用量需要设置 stream_options: { "include_usage": true }, 详见用量与计费。

本页目录