创建 Chat Completions 对话

curl --request POST \
  --url https://api.aichs365.com/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-4.1-mini",
  "messages": [
    {
      "role": "system",
      "content": "你是一个简洁的中文助手。"
    },
    {
      "role": "user",
      "content": "用三句话介绍杭州。"
    }
  ],
  "stream": false,
  "max_completion_tokens": 500
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'gpt-4.1-mini',
    messages: [
      {role: 'system', content: '你是一个简洁的中文助手。'},
      {role: 'user', content: '用三句话介绍杭州。'}
    ],
    stream: false,
    max_completion_tokens: 500
  })
};

fetch('https://api.aichs365.com/v1/chat/completions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.aichs365.com/v1/chat/completions"

payload = {
    "model": "gpt-4.1-mini",
    "messages": [
        {
            "role": "system",
            "content": "你是一个简洁的中文助手。"
        },
        {
            "role": "user",
            "content": "用三句话介绍杭州。"
        }
    ],
    "stream": False,
    "max_completion_tokens": 500
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "chatcmpl_demo",
  "object": "chat.completion",
  "created": 1788067200,
  "model": "gpt-4.1-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "杭州因西湖闻名，也是一座数字经济活跃的城市。这里兼具江南文化、自然景观与现代产业。四季皆有不同的城市风貌。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 42,
    "total_tokens": 67
  }
}

{
  "error": {
    "message": "model 字段必填",
    "type": "invalid_request_error",
    "param": null,
    "code": "gateway_error"
  }
}

{
  "error": {
    "message": "invalid api key",
    "type": "invalid_api_key",
    "param": null,
    "code": "gateway_error"
  }
}

{
  "error": {
    "message": "上游请求失败",
    "type": "server_error",
    "param": null,
    "code": "gateway_error"
  }
}

{
  "error": {
    "message": "upstream request rejected",
    "type": "upstream_error",
    "code": "provider_error"
  }
}

POST

chat

completions

创建 Chat Completions 对话

curl --request POST \
  --url https://api.aichs365.com/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-4.1-mini",
  "messages": [
    {
      "role": "system",
      "content": "你是一个简洁的中文助手。"
    },
    {
      "role": "user",
      "content": "用三句话介绍杭州。"
    }
  ],
  "stream": false,
  "max_completion_tokens": 500
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'gpt-4.1-mini',
    messages: [
      {role: 'system', content: '你是一个简洁的中文助手。'},
      {role: 'user', content: '用三句话介绍杭州。'}
    ],
    stream: false,
    max_completion_tokens: 500
  })
};

fetch('https://api.aichs365.com/v1/chat/completions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.aichs365.com/v1/chat/completions"

payload = {
    "model": "gpt-4.1-mini",
    "messages": [
        {
            "role": "system",
            "content": "你是一个简洁的中文助手。"
        },
        {
            "role": "user",
            "content": "用三句话介绍杭州。"
        }
    ],
    "stream": False,
    "max_completion_tokens": 500
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "chatcmpl_demo",
  "object": "chat.completion",
  "created": 1788067200,
  "model": "gpt-4.1-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "杭州因西湖闻名，也是一座数字经济活跃的城市。这里兼具江南文化、自然景观与现代产业。四季皆有不同的城市风貌。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 42,
    "total_tokens": 67
  }
}

{
  "error": {
    "message": "model 字段必填",
    "type": "invalid_request_error",
    "param": null,
    "code": "gateway_error"
  }
}

{
  "error": {
    "message": "invalid api key",
    "type": "invalid_api_key",
    "param": null,
    "code": "gateway_error"
  }
}

{
  "error": {
    "message": "上游请求失败",
    "type": "server_error",
    "param": null,
    "code": "gateway_error"
  }
}

{
  "error": {
    "message": "upstream request rejected",
    "type": "upstream_error",
    "code": "provider_error"
  }
}

Authorizations

Authorization

string

header

required

仅服务端使用的应用密钥。Authorization 请求头格式为 Bearer APP_SECRET；不要在浏览器或客户端应用中暴露。

Body

application/json

Chat Completions 兼容请求；除下列通用字段外，模型支持的扩展字段会原样传递给上游。

model

string

required

模型目录返回的 model_code，不是模型展示名称。

Minimum string length: 1

messages

object[]

required

按时间顺序排列的对话消息列表。

Minimum array length: 1

Hide child attributes

messages.role

enum<string>

required

消息发送方角色：system、user、assistant 或 tool。

Available options:

system,

user,

assistant,

tool

messages.content

required

消息正文；可为纯文本，或模型支持的多模态内容片段数组。

messages.name

string

消息发送方名称；仅在模型或工具调用需要区分名称时填写。

messages.tool_call_id

string

工具返回消息对应的工具调用 ID；role=tool 时使用。

stream

boolean

default:false

是否使用 SSE 流式返回；只有 JSON 布尔值 true 会启用流式。

max_completion_tokens

integer

允许模型生成的最大 Token 数，优先用于较新的 Chat Completions 模型。

Required range: x >= 1

max_tokens

integer

允许模型生成的最大 Token 数，供仍使用旧字段的模型使用。

Required range: x >= 1

max_output_tokens

integer

兼容部分上游模型的最大输出 Token 字段；Chat Completions 优先使用 max_completion_tokens 或 max_tokens。

Required range: x >= 1

temperature

number

采样随机度；支持范围由实际模型决定。

top_p

number

核采样概率阈值；支持范围由实际模型决定。

tools

object[]

可供模型调用的工具定义列表；具体结构遵循所选模型的 OpenAI 兼容格式。

tool_choice

控制模型是否或如何选择工具，可填模型支持的字符串或工具选择对象。

response_format

object

模型输出格式约束，例如 JSON 对象或 JSON Schema；仅在所选模型支持时使用。

user

string

由调用方提供的终端用户稳定标识，用于上游安全策略；不要传入明文敏感信息。

Response

非流式请求返回 JSON；stream=true 时返回 SSE 数据流。

Chat Completions 非流式成功响应；上游模型可能附带额外兼容字段。

string

required

本次对话响应的唯一标识。

object

string

required

响应对象类型，通常为 chat.completion。

created

integer<int64>

required

响应创建时的秒级 Unix 时间戳。

model

string

required

实际执行本次对话的模型标识。

choices

object[]

required

模型生成的候选回答列表。

Hide child attributes

choices.index

integer

required

候选回答在列表中的序号。

choices.message

object

required

模型返回的 assistant 消息。

Hide child attributes

choices.message.role

string

模型消息角色，通常为 assistant。

choices.message.content

string | null

模型生成的文本；仅工具调用时可能为空。

choices.message.tool_calls

object[]

模型生成的工具调用列表；没有工具调用时不返回。

choices.finish_reason

string | null

生成停止原因，例如 stop、length 或 tool_calls。

usage

object

Chat Completions 请求的 Token 用量。

Hide child attributes

usage.prompt_tokens

integer

本次请求消耗的输入 Token 数。

Required range: x >= 0

usage.completion_tokens

integer

本次请求生成的输出 Token 数。

Required range: x >= 0

usage.total_tokens

integer

本次请求输入与输出 Token 的合计数。

Required range: x >= 0

账号中心

智能任务

大模型

海外社媒

创建 Chat Completions 对话

Authorizations

Body

Response