扫描二维码即可赞赏支持
感谢您的支持，这将帮助我们提供更好的服务
接口地址:
https://apiserver.alcex.cn/v1/chat/completions
请求方式:
POST
返回格式:
JSON
Curl请求示例:
curl -X POST 'https://apiserver.alcex.cn/v1/chat/completions' -H 'Content-Type: application/json' -d '{
"model": "claude-sonnet-4",
"messages": [
{
"role": "user",
"content": "你好"
}
],
"stream": false
}'请求参数:
请求体参数(request_body):
{
"model": "claude-sonnet-4", // 必需，模型名称id
"messages": [ // 必需，聊天消息历史
{
"role": "system", // 消息角色 (system/user/assistant)
"content": "你是一个有帮助的助手" // 消息内容
},
{
"role": "user",
"content": "你好"
}
],
"max_tokens": 1000, // 可选，生成的最大token数
"temperature": 0.7, // 可选，控制随机性 (0-2)，值越高输出越随机
"top_p": 1.0, // 可选，核采样概率 (0-1)，与temperature二选一
"n": 1, // 可选，生成多少个回复
"stream": false, // 可选，是否流式输出
"stop": ["\n", "。"], // 可选，停止生成的标记
"presence_penalty": 0.0, // 可选，主题重复惩罚 (-2.0到2.0)
"frequency_penalty": 0.0, // 可选，频率重复惩罚 (-2.0到2.0)
"logit_bias": { // 可选，特定token的偏向调整
"token_id": 0.5 // token_id和偏向值 (-100到100)
},
"user": "user123" // 可选，用户标识(用于滥用检测)
}返回参数:
| 名称 | 类型 | 说明 |
|---|---|---|
| id | string | 本次对话的唯一标识ID |
| object | string | 对象类型（如 chat.completion） |
| created | string | 对话创建的时间戳（Unix 时间） |
| model | string | 实际使用的模型ID（如 gpt-3.5-turbo） |
| choices | array | 生成的对话选项列表 |
| usage | object | Token 使用统计 |
| system_fingerprint | string | 系统指纹（用于监控和调试） |
状态码说明:
| 状态码 | 状态 | 说明 |
|---|---|---|
| 200 | 成功 | 请求成功，返回正确的数据 |
| 400 | 请求错误 | 请求参数错误或缺失必要参数 |
| 401 | 未授权 | 缺少有效的身份验证凭据 |
| 403 | 禁止访问 | 服务器理解请求但拒绝执行 |
| 404 | 未找到 | 请求的资源不存在 |
| 429 | 请求过多 | 请求频率超过限制 |
| 500 | 服务器错误 | 服务器内部错误 |
| 502 | 网关错误 | 网关或代理服务器错误 |
| 503 | 服务不可用 | 服务器暂时无法处理请求 |
返回示例:
{
"id": "chatcmpl-4ed521b2ad0a4e94aef9956ef6c27490",
"object": "chat.completion",
"created": 1755449417,
"model": "claude-sonnet-4",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好！我是Claude，很高兴能帮助你解决编程相关的问题。有什么我可以帮你的吗？"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"total_tokens": 0
}
}错误返回示例:
{
"code": 400,
"error": "请求参数验证失败",
"message": "请求参数缺失或无效,请查看官网文档以解决此问题:https://api.alcex.cn/",
"details": [
"query.id: Field required"
],
"timestamp": 1755182973,
"request_id": "21646ea2a01c461298cdbdbdb3f3a663"
}{
"code": 404,
"error": "HTTP错误",
"message": "Not Found",
"timestamp": 1755182878,
"request_id": "9ddc3b08d6724e4eafc2b4e2c1f24190"
}{
"code": 500,
"error": "请求错误",
"message": "请求处理过程中发生错误,请检查请求参数是否正确",
"timestamp": 1755182846,
"request_id": "1cb82ff6aac5482caeac1999df66dccb"
}多语言代码示例:
正在生成代码示例...提示：在线测试可能无法正常返回数据，建议使用专业工具测试。
使用专业的API调试工具进行更详细的测试