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"
}
}创建 Chat Completions 对话
使用 OpenAI 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 请求头格式为 Bearer APP_SECRET;不要在浏览器或客户端应用中暴露。
Body
Chat Completions 兼容请求;除下列通用字段外,模型支持的扩展字段会原样传递给上游。
模型目录返回的 model_code,不是模型展示名称。
1按时间顺序排列的对话消息列表。
1Hide child attributes
Hide child attributes
是否使用 SSE 流式返回;只有 JSON 布尔值 true 会启用流式。
允许模型生成的最大 Token 数,优先用于较新的 Chat Completions 模型。
x >= 1允许模型生成的最大 Token 数,供仍使用旧字段的模型使用。
x >= 1兼容部分上游模型的最大输出 Token 字段;Chat Completions 优先使用 max_completion_tokens 或 max_tokens。
x >= 1采样随机度;支持范围由实际模型决定。
核采样概率阈值;支持范围由实际模型决定。
可供模型调用的工具定义列表;具体结构遵循所选模型的 OpenAI 兼容格式。
控制模型是否或如何选择工具,可填模型支持的字符串或工具选择对象。
模型输出格式约束,例如 JSON 对象或 JSON Schema;仅在所选模型支持时使用。
由调用方提供的终端用户稳定标识,用于上游安全策略;不要传入明文敏感信息。
Response
非流式请求返回 JSON;stream=true 时返回 SSE 数据流。
Chat Completions 非流式成功响应;上游模型可能附带额外兼容字段。
本次对话响应的唯一标识。
响应对象类型,通常为 chat.completion。
响应创建时的秒级 Unix 时间戳。
实际执行本次对话的模型标识。
模型生成的候选回答列表。
Hide child attributes
Hide child attributes
候选回答在列表中的序号。
生成停止原因,例如 stop、length 或 tool_calls。