聊天与文本

OpenAI 兼容v1

OpenAI 兼容的聊天补全格式，支持普通响应与 SSE 流式响应。

POSThttps://api.your-starai-domain.com/v1/chat/completions

请求格式

application/json

响应模式

sync_or_stream

鉴权方式

Bearer

接口协议

OpenAI 兼容

调用约定

文档版本

v1

限流

以平台配置为准

幂等键

暂未启用

支持的模型

当前没有已发布的模型文档。

鉴权

管理 API Key

Authorization: Bearer <API_KEY>

请求头

名称	值	说明
Authorization	Bearer <API_KEY>	用于 API 鉴权
Content-Type	application/json	请求体使用 JSON 格式

请求示例

curl https://api.your-starai-domain.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>"

在线调试

仅当前页面使用，不保存 API Key

填写 API Key 后发送真实请求。接口地址可以按部署环境修改；任务查询接口需要先替换路径中的 task_no。

启用实时流式响应

流式事件

设置 stream=true 后接收 OpenAI 兼容的 SSE 事件。

data: {
  "id": "chatcmpl_xxx",
  "object": "chat.completion.chunk",
  "choices": [{ "index": 0, "delta": { "content": "你好，请介绍你的能力" }, "finish_reason": null }]
}

data: [DONE]

请求参数

名称	类型	必填	说明
model	string	是	平台模型编码或后台接入模型名
messages	array	是	OpenAI Chat Completions 消息数组
stream	boolean	否	是否通过 SSE 返回流式片段
temperature	number	否	采样温度，以接入模型支持范围为准
max_tokens	integer	否	最大输出 Token 数
tools	array	否	工具定义，用于工具调用

请求体

{}

响应示例

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "..."
      },
      "finish_reason": "stop"
    }
  ]
}

名称

值

说明

Authorization

Bearer <API_KEY>

用于 API 鉴权

Content-Type

application/json

请求体使用 JSON 格式

请求参数

名称	类型	必填	说明
model	string	是	平台模型编码或后台接入模型名
messages	array	是	OpenAI Chat Completions 消息数组
stream	boolean	否	是否通过 SSE 返回流式片段
temperature	number	否	采样温度，以接入模型支持范围为准
max_tokens	integer	否	最大输出 Token 数
tools	array	否	工具定义，用于工具调用

{ "id": "chatcmpl_xxx", "object": "chat.completion", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "..." }, "finish_reason": "stop" } ] }