curl --request POST \
--url https://api.aihubmax.com/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gpt-5.4",
"input": "解释一下 RESTful API 的设计原则"
}
'{
"id": "resp_abc123",
"object": "response",
"created_at": 1757165031,
"model": "<string>",
"status": "completed",
"output": [
{
"type": "message",
"id": "msg_abc123",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "Hello! How can I help you today?"
}
]
}
],
"usage": {
"input_tokens": 20,
"output_tokens": 50,
"total_tokens": 70
}
}{
"error": {
"message": "请求参数无效",
"type": "invalid_request_error"
}
}{
"error": {
"message": "API密钥无效",
"type": "authentication_error"
}
}{
"error": {
"message": "请求参数无效",
"type": "invalid_request_error"
}
}{
"error": {
"message": "访问被拒绝",
"type": "permission_error"
}
}{
"error": {
"message": "请求频率超限",
"type": "rate_limit_error"
}
}{
"error": {
"message": "服务器内部错误",
"type": "server_error"
}
}调用工具
OpenAI 格式 - 响应
- 适用于所有兼容 Responses API 格式模型的通用参考
- 服务端上下文存储:通过 previous_response_id 实现多轮对话,无需手动传历史消息
- 支持流式和非流式响应
- 多模态输入:支持文本 + 图像 + 文件混合输入
- 工具调用:支持 Function Calling 和内置工具
- 结构化输出:支持 JSON Schema 格式
POST
/
v1
/
responses
curl --request POST \
--url https://api.aihubmax.com/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gpt-5.4",
"input": "解释一下 RESTful API 的设计原则"
}
'{
"id": "resp_abc123",
"object": "response",
"created_at": 1757165031,
"model": "<string>",
"status": "completed",
"output": [
{
"type": "message",
"id": "msg_abc123",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "Hello! How can I help you today?"
}
]
}
],
"usage": {
"input_tokens": 20,
"output_tokens": 50,
"total_tokens": 70
}
}{
"error": {
"message": "请求参数无效",
"type": "invalid_request_error"
}
}{
"error": {
"message": "API密钥无效",
"type": "authentication_error"
}
}{
"error": {
"message": "请求参数无效",
"type": "invalid_request_error"
}
}{
"error": {
"message": "访问被拒绝",
"type": "permission_error"
}
}{
"error": {
"message": "请求频率超限",
"type": "rate_limit_error"
}
}{
"error": {
"message": "服务器内部错误",
"type": "server_error"
}
}授权
所有接口均需要使用Bearer Token进行认证
使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY
请求体
application/json
模型名称
示例:
"gpt-5.4"
用于生成响应的文本输入或消息列表
是否流式返回响应
采样温度 (0-2)
必填范围:
0 <= x <= 2最大输出token生成数
核采样参数 (0-1)
必填范围:
0 <= x <= 1上一个响应的ID,用于多轮对话
系统级指令
可用工具列表
Show child attributes
Show child attributes
文本输出格式配置
Show child attributes
Show child attributes