AnyStarX Wiki

通过兼容 OpenAI 标准的 Chat Completions 接口实现多轮文本对话、内容生成与代码任务。

Chat Completions 接口遵循标准的 OpenAI 协议规范，具备广泛的生态兼容性，适用于各类客户端插件、自动化脚本以及基于 OpenAI SDK 构建的应用程序。

接口地址

POST https://console.anystarx.com/v1/chat/completions

请求体结构

{
  "model": "MODEL_ID",
  "messages": [
    {
      "role": "system",
      "content": "你是一个严谨的技术文档助手。"
    },
    {
      "role": "user",
      "content": "请用一段话简要介绍 RESTful API 的核心设计理念。"
    }
  ],
  "temperature": 0.7
}

命令行调用示例

curl https://console.anystarx.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "编写一个标准的 Python 异常处理示例代码。"
      }
    ],
    "temperature": 0.2
  }'

开启流式输出

如果需要在模型生成内容的过程中实时接收文本增量，可以在请求体中增加 "stream": true：

{
  "model": "MODEL_ID",
  "stream": true,
  "messages": [
    {
      "role": "user",
      "content": "请列举网络通信中三次握手的步骤。"
    }
  ]
}

使用 curl 进行流式调用的命令如下：

curl https://console.anystarx.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "stream": true,
    "messages": [
      {
        "role": "user",
        "content": "请列举网络通信中三次握手的步骤。"
      }
    ]
  }'

关于 Server-Sent Events（SSE）协议解析、客户端事件驱动读取以及用量统计参数配置，可以查阅流式输出。

核心请求参数

参数名称	类型	说明
`model`	string	必需。要调用的模型完整标识符，需从控制台复制
`messages`	array	必需。包含多轮历史交互的消息对象数组
`temperature`	number	可选。采样随机性，取值范围通常在 0 到 2 之间，数值越小输出越收敛确定
`max_tokens`	integer	可选。单次生成允许返回的最大 token 数量限制
`stream`	boolean	可选。是否以流式 SSE 协议逐步推送文本增量，默认为 `false`

各上游模型对超参数的边界约束可能略有不同。在调试自定义参数时，若收到 400 错误，建议先仅保留 model 与 messages 进行最小化测试，再逐项加入微调参数。

常见调用问题

客户端配置中的 Base URL 填写规范

在第三方软件或 SDK 初始化时，Base URL 统一填入基础端点 https://console.anystarx.com/v1。客户端在实际发起调用时会自动在末尾拼接 /chat/completions。只有在使用 curl 直接发起底层 HTTP 请求时，才需要输入包含具体路径的完整地址。

`messages` 数组与旧版 `prompt` 字段的区别

Chat Completions 接口使用 messages 数组组织结构化的多轮会话（支持 system、user、assistant 等角色）。早期旧版 Completions 接口中使用的单字符串 prompt 字段现已逐步淘汰，新项目开发建议全面采用 messages 格式。

收到 `model_not_found` 错误的处理

当返回模型不存在错误时，应当登录控制台核对模型列表，确保复制了完整的模型 ID。不要使用界面的展示名称或省略提供商前缀的简称发起请求。

Chat Completions

本页内容