Openai Response 接口格式调用
o3-pro 必须用 Response 接口格式调用
Response API 是Openai 新一代API接口规范。 o3-pro 模型必须使用特定格式进行调用。
基础概念
流式输出(Streaming Output)是一种实时内容呈现方式,其核心特征是将信息以逐字或逐段的形式动态展示。这种输出模式主要应用于以下典型场景: 即时通讯对话界面、数字人直播互动、实时信息推送系统。
技术特点:实现低延迟的内容传输、增强用户交互体验、模拟自然语言交流节奏。
注:与传统的整段输出相比,流式输出更符合人类对话的自然节奏,能有效提升交互场景的用户体验。
参数说明
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
api_key | string | 是 | DMXAPI认证密钥 |
base_url | string | 是 | API服务地址 |
model | string | 是 | 指定模型 |
input | string | 是 | 输入的文本内容 |
request 调用示例
python
import os
import requests
# API 的 URL 地址
url = "https://www.dmxapi.cn/v1/responses"
api_key = "sk-*****************************" # 替换为你的API密钥
# 构建请求头
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {api_key}",
}
# 构建请求数据
data = {
"model": "gpt-4.1",
"input": "从1数到10?",
}
# 发送 POST 请求
# requests.post 方法会自动将字典 `data` 转换为 JSON 格式
response = requests.post(url, headers=headers, json=data)
# 打印服务器返回的 JSON 响应内容
# 如果需要查看状态码等其他信息,可以使用 response.status_code
print(response.json())
流式响应返回
json
data: {"type":"response.created","sequence_number":0,"response":{"id":"resp_687a5fa4351c819a8e4feed49ed4adb7071d30e59d498fae","object":"response","created_at":1752850340,"status":"in_progress","background":false,"error":null,"incomplete_details":null,"instructions":null,"max_output_tokens":null,"max_tool_calls":null,"model":"gpt-4.1-2025-04-14","output":[],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"service_tier":"auto","store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_logprobs":0,"top_p":1.0,"truncation":"disabled","usage":null,"user":null,"metadata":{}}}
event: response.in_progress
data: {"type":"response.in_progress","sequence_number":1,"response":{"id":"resp_687a5fa4351c819a8e4feed49ed4adb7071d30e59d498fae","object":"response","created_at":1752850340,"status":"in_progress","background":false,"error":null,"incomplete_details":null,"instructions":null,"max_output_tokens":null,"max_tool_calls":null,"model":"gpt-4.1-2025-04-14","output":[],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"service_tier":"auto","store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_logprobs":0,"top_p":1.0,"truncation":"disabled","usage":null,"user":null,"metadata":{}}}
event: response.output_item.added
data: {"type":"response.output_item.added","sequence_number":2,"output_index":0,"item":{"id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","type":"message","status":"in_progress","content":[],"role":"assistant"}}
event: response.content_part.added
data: {"type":"response.content_part.added","sequence_number":3,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"part":{"type":"output_text","annotations":[],"logprobs":[],"text":""}}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":4,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"å½ç¶","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":5,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"å¯ä»¥","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":6,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"ï¼","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":7,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"ä»","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":8,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" ","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":9,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"1","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":10,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" æ°","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":11,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"å°","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":12,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" ","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":13,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"10","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":14,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" æ¯","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":15,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"ï¼\n\n","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":16,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"1","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":17,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":",","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":18,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" ","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":19,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"2","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":20,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":",","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":21,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" ","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":22,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"3","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":23,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":",","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":24,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" ","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":25,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"4","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":26,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":",","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":27,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" ","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":28,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"5","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":29,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":",","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":30,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" ","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":31,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"6","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":32,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":",","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":33,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" ","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":34,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"7","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":35,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":",","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":36,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" ","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":37,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"8","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":38,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":",","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":39,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" ","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":40,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"9","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":41,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":",","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":42,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":" ","logprobs":[]}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":43,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"delta":"10","logprobs":[]}
event: response.output_text.done
data: {"type":"response.output_text.done","sequence_number":44,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"text":"å½ç¶å¯ä»¥ï¼ä» 1 æ°å° 10 æ¯ï¼\n\n1, 2, 3, 4, 5, 6, 7, 8, 9, 10","logprobs":[]}
event: response.content_part.done
data: {"type":"response.content_part.done","sequence_number":45,"item_id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","output_index":0,"content_index":0,"part":{"type":"output_text","annotations":[],"logprobs":[],"text":"å½ç¶å¯ä»¥ï¼ä» 1 æ°å° 10 æ¯ï¼\n\n1, 2, 3, 4, 5, 6, 7, 8, 9, 10"}}
event: response.output_item.done
data: {"type":"response.output_item.done","sequence_number":46,"output_index":0,"item":{"id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","type":"message","status":"completed","content":[{"type":"output_text","annotations":[],"logprobs":[],"text":"å½ç¶å¯ä»¥ï¼ä» 1 æ°å° 10 æ¯ï¼\n\n1, 2, 3, 4, 5, 6, 7, 8, 9, 10"}],"role":"assistant"}}
event: response.completed
data: {"type":"response.completed","sequence_number":47,"response":{"id":"resp_687a5fa4351c819a8e4feed49ed4adb7071d30e59d498fae","object":"response","created_at":1752850340,"status":"completed","background":false,"error":null,"incomplete_details":null,"instructions":null,"max_output_tokens":null,"max_tool_calls":null,"model":"gpt-4.1-2025-04-14","output":[{"id":"msg_687a5fa4fbd4819aa4bce0274c91eb66071d30e59d498fae","type":"message","status":"completed","content":[{"type":"output_text","annotations":[],"logprobs":[],"text":"å½ç¶å¯ä»¥ï¼ä» 1 æ°å° 10 æ¯ï¼\n\n1, 2, 3, 4, 5, 6, 7, 8, 9, 10"}],"role":"assistant"}],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"service_tier":"default","store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_logprobs":0,"top_p":1.0,"truncation":"disabled","usage":{"input_tokens":13,"input_tokens_details":{"cached_tokens":0},"output_tokens":41,"output_tokens_details":{"reasoning_tokens":0},"total_tokens":54},"user":null,"metadata":{}}}