模型与参数
列出模型并了解常用的 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 字段。以下是最常用的参数:
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填。使用 GET /v1/models 返回的 id。 |
messages | array | 必填。按顺序排列的对话轮次,包含 role 和 content。 |
stream | boolean | 返回服务器发送事件,而不是一次性返回完整响应。 |
temperature | number | 值越高,输出越多样。默认值为 1。 |
top_p | number | 核采样。调整此参数或 temperature,不要同时调整两者。 |
max_tokens | integer | 限制生成内容的长度,不包含提示词。 |
stop | string 或 array | 最多 4 个用于结束生成的序列。 |
tools、response_format 和视觉输入等可选字段的支持情况因模型而异。
模型不支持某个参数时,API 会返回 400 并指出对应字段,而不会静默忽略。