什么是 Responses API？
Responses API 是与 OpenAI 模型交互的一种新方式，它比以前的 API 更简单、更灵活。它使构建使用多种工具、处理多轮对话以及处理不同类型数据（不仅仅是文本）的高级 AI 应用程序变得容易。
与主要为文本构建的 Chat Completions 等旧 API，或可能需要大量设置的 Assistants API 不同，Responses API 从头开始构建，用于：
- 无缝的多轮交互（在单个 API 调用中进行多步对话）
- 轻松访问强大的托管工具（如文件搜索、网络搜索和代码解释器）
- 精细控制发送到模型的上下文
随着 AI 模型在复杂、长时间运行的推理方面变得越来越强大，开发人员需要一个异步且有状态的 API。Responses API 旨在满足这些需求。
在本指南中，您将看到 Responses API 提供的一些新功能，以及一些实用的示例来帮助您入门。
基础
从设计上讲，Responses API 在表面上与 Completions API 非常相似。
from openai import OpenAI
import os
client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
response = client.responses.create(
model="gpt-4o-mini",
input="讲个笑话",
)
print(response.output[0].content[0].text)
为什么稻草人获奖了？
因为它在自己的领域里很出色！
Response API 的一个关键特性是它是有状态的。这意味着您不必自己管理对话状态，API 会为您处理。例如，您可以随时检索响应，它将包含完整的对话历史记录。
fetched_response = client.responses.retrieve(
response_id=response.id)
print(fetched_response.output[0].content[0].text)
为什么稻草人获奖了？
因为它在自己的领域里很出色！
您可以继续对话，引用之前的响应。
response_two = client.responses.create(
model="gpt-4o-mini",
input="再讲一个",
previous_response_id=response.id
)
print(response_two.output[0].content[0].text)
为什么骷髅们不互相打架？
他们没有胆量！
当然，您也可以自己管理上下文。但 OpenAI 为您维护上下文的一个好处是，您可以在任何时候分叉响应并从该点继续对话。
response_two_forked = client.responses.create(
model="gpt-4o-mini",
input="我不喜欢那个笑话，再讲一个，并告诉我这两个笑话的区别",
previous_response_id=response.id # 从第一个响应分叉并继续
)
output_text = response_two_forked.output[0].content[0].text
print(output_text)
当然！这是另一个笑话：
为什么科学家不相信原子？
因为它们构成了一切！
**区别：**第一个笑话利用了“杰出”（outstanding）的双关语，既有字面意思也有优秀的意思，而第二个笑话则依赖于关于原子“构成”（make up）物质与捏造故事的双关语。每个笑话都使用了文字游戏，但它们针对的是不同的概念（农业与科学）。
托管工具
Responses API 的另一个好处是它增加了对 file_search 和 web_search 等托管工具的支持。您无需手动调用工具，只需传入工具，API 就会决定使用哪个工具并进行调用。
以下是使用 web_search 工具将网络搜索结果合并到响应中的示例。
response = client.responses.create(
model="gpt-4o", # 或其他支持的模型
input="关于 AI 的最新消息是什么？",
tools=[
{
"type": "web_search"
}
]
)
import json
print(json.dumps(response.output, default=lambda o: o.__dict__, indent=2))
[
{
"id": "ws_67bd64fe91f081919bec069ad65797f1",
"status": "completed",
"type": "web_search_call"
},
{
"id": "msg_67bd6502568c8191a2cbb154fa3fbf4c",
"content": [
{
"annotations": [
{
"index": null,
"title": "华为提高 AI 芯片产量，助力中国科技目标",
"type": "url_citation",
"url": "https://www.ft.com/content/f46b7f6d-62ed-4b64-8ad7-2417e5ab34f6?utm_source=chatgpt.com"
},
{
"index": null,
"title": "苹果因特朗普的 5000 亿美元美国投资计划而欢呼；华尔街更多损失——实时报道",
"type": "url_citation",
"url": "https://www.theguardian.com/business/live/2025/feb/24/euro-hits-one-month-high-german-election-result-stock-markets-dax-bank-of-england-business-live-news?utm_source=chatgpt.com"
},
{
"index": null,
"title": "微软因 DeepSeek 对大规模 AI 支出表示怀疑而取消数据中心租赁：报告",
"type": "url_citation",
"url": "https://nypost.com/2025/02/24/business/microsoft-axes-some-ai-data-center-leases-td-cowen-says/?utm_source=chatgpt.com"
},
{
"index": null,
"title": "阿里巴巴计划未来三年投资 520 亿美元用于 AI 和云",
"type": "url_citation",
"url": "https://www.investopedia.com/alibaba-plans-to-invest-usd52b-in-ai-cloud-over-next-three-years-11684981?utm_source=chatgpt.com"
},
{
"index": null,
"title": "摩根大通部门以 2.7 亿美元估值支持 Albert Invent",
"type": "url_citation",
"url": "https://www.wsj.com/articles/jpmorgan-unit-backs-albert-invent-at-a-270-million-valuation-1ab03c96?utm_source=chatgpt.com"
}
],
"text": "截至 2025 年 2 月 25 日，人工智能 (AI) 领域出现了几项重大进展：\n\n**华为在 AI 芯片生产方面取得进展**\n\n华为显著提高了其 AI 芯片生产能力，将其 Ascend 910C 处理器的良品率从 20% 提高到近 40%。这一改进首次使生产线实现盈利，并且对于中国实现先进半导体自给自足的雄心至关重要。尽管取得了这些进展，英伟达仍凭借其用户友好的软件和广泛的应用在中国的 AI 芯片市场占据主导地位。华为的目标是将其良品率进一步提高到 60%，并计划在 2025 年生产 100,000 个 Ascend 910C 处理器和 300,000 个 910B 芯片。（[ft.com](https://www.ft.com/content/f46b7f6d-62ed-4b64-8ad7-2417e5ab34f6?utm_source=chatgpt.com)）\n\n**苹果公司 5000 亿美元美国投资计划**\n\n苹果公司公布了一项为期四年、在美国投资 5000 亿美元的重大投资计划。该计划包括创造 20,000 个新就业岗位，并在德克萨斯州建立一个专门用于制造人工智能服务器的主要工厂。唐纳德·特朗普总统称赞了这项举措，认为这是对其政府的信心体现。与此同时，由于对经济可能放缓的担忧，华尔街经历了进一步的损失，关税加剧了这种担忧。（[theguardian.com](https://www.theguardian.com/business/live/2025/feb/24/euro-hits-one-month-high-german-election-result-stock-markets-dax-bank-of-england-business-live-news?utm_source=chatgpt.com)）\n\n**微软调整 AI 数据中心投资**\n\n微软已取消了总计达数百兆瓦的美国数据中心租赁，这可能会影响两个大型中心。据报道，此决定与对供应过剩的担忧有关，此前中国竞争对手 DeepSeek 声称其开发的生成式聊天机器人比美国公司更有效率。分析人士认为，微软可能正在重新分配资金，或对 OpenAI 转向 Oracle 进行 5000 亿美元项目做出回应。尽管微软是人工智能领域的领先投资者，今年的计划支出为 800 亿美元，但它似乎正在缩减大规模支出计划，允许重要的数据中心协议到期，并提及设施和电力延迟。（[nypost.com](https://nypost.com/2025/02/24/business/microsoft-axes-some-ai-data-center-leases-td-cowen-says/?utm_source=chatgpt.com)）\n\n**阿里巴巴计划未来三年投资 520 亿美元用于 AI 和云基础设施**\n\n阿里巴巴集团宣布计划在未来三年内投资超过 520 亿美元用于人工智能和云基础设施，超过了其过去十年在这些领域的总投资。这一战略举措凸显了阿里巴巴对人工智能驱动增长的承诺，并巩固了其作为全球领先云服务提供商的地位。在此声明之后，阿里巴巴在美国上市的股票在盘前交易中下跌了 3%。分析人士认为，这项投资符合市场预期，并表明阿里巴巴云与同行相比，资本支出巨大。（[investopedia.com](https://www.investopedia.com/alibaba-plans-to-invest-usd52b-in-ai-cloud-over-next-three-years-11684981?utm_source=chatgpt.com)）\n\n**摩根大通投资 AI 驱动的化学品开发**\n\n摩根大通的私人投资部门牵头向 Albert Invent 进行了 2000 万美元的增长投资，该公司是一家人工智能驱动的化学品开发平台，估值为 2.7 亿美元。这笔资金将使 Albert Invent 能够进行全球扩张，并将其员工人数从 120 人增加到今年年底的 200 多人。该公司协助化学家开发新配方和材料，显著加快了化学实验。例如，Albert 的平台可以为 Nouryon Chemicals 等客户模拟 100,000 次实验，耗时 10 分钟。（[wsj.com](https://www.wsj.com/articles/jpmorgan-unit-backs-albert-invent-at-a-270-million-valuation-1ab03c96?utm_source=chatgpt.com)）\n\n这些进展反映了人工智能领域动态且快速发展的格局，主要公司和金融机构正在进行大量投资以推进该领域的技术和基础设施。\n\n\n# 截至 2025 年 2 月 25 日的关键 AI 发展：\n- [华为提高 AI 芯片产量，助力中国科技目标](https://www.ft.com/content/f46b7f6d-62ed-4b64-8ad7-2417e5ab34f6?utm_source=chatgpt.com)\n- [苹果因特朗普的 5000 亿美元美国投资计划而欢呼；华尔街更多损失——实时报道](https://www.theguardian.com/business/live/2025/feb/24/euro-hits-one-month-high-german-election-result-stock-markets-dax-bank-of-england-business-live-news?utm_source=chatgpt.com)\n- [微软因 DeepSeek 对大规模 AI 支出表示怀疑而取消数据中心租赁：报告](https://nypost.com/2025/02/24/business/microsoft-axes-some-ai-data-center-leases-td-cowen-says/?utm_source=chatgpt.com)\n ",
"type": "output_text",
"logprobs": null
}
],
"role": "assistant",
"type": "message"
}
]
多模态、工具增强型对话
Responses API 原生支持文本、图像和音频模态。 将所有内容整合在一起，我们可以通过 Responses API 的单个 API 调用来构建完全多模态、工具增强型的交互。
import base64
from IPython.display import Image, display
# Display the image from the provided URL
url = "https://upload.wikimedia.org/wikipedia/commons/thumb/1/15/Cat_August_2010-4.jpg/2880px-Cat_August_2010-4.jpg"
display(Image(url=url, width=400))
response_multimodal = client.responses.create(
model="gpt-4o",
input=[
{
"role": "user",
"content": [
{"type": "input_text", "text":
"根据图片生成相关的关键词，并使用搜索工具搜索与这些关键词相关的任何新闻，总结发现并引用来源。"},
{"type": "input_image", "image_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/1/15/Cat_August_2010-4.jpg/2880px-Cat_August_2010-4.jpg"}
]
}
],
tools=[
{"type": "web_search"}
]
)
import json
print(json.dumps(response_multimodal.__dict__, default=lambda o: o.__dict__, indent=4))
{
"id": "resp_67bd65392a088191a3b802a61f4fba14",
"created_at": 1740465465.0,
"error": null,
"metadata": {},
"model": "gpt-4o-2024-08-06",
"object": "response",
"output": [
{
"id": "msg_67bd653ab9cc81918db973f0c1af9fbb",
"content": [
{
"annotations": [],
"text": "根据猫的图片，一些相关的关键词可能是：\n\n- 猫\n- 猫科动物\n- 宠物\n- 宠物护理\n- 猫的行为\n\n我将搜索与这些关键词相关的最新新闻。",
"type": "output_text",
"logprobs": null
}
],
"role": "assistant",
"type": "message"
},
{
"id": "ws_67bd653c7a548191af86757fbbca96e1",
"status": "completed",
"type": "web_search_call"
},
{
"id": "msg_67bd653f34fc8191989241b2659fd1b5",
"content": [
{
"annotations": [
{
"index": null,
"title": "猫奇迹般地在搬家过程中被困沙发三周后幸存下来",
"type": "url_citation",
"url": "https://nypost.com/2025/02/24/us-news/cat-miraculously-survives-3-weeks-trapped-in-sofa-during-familys-cross-country-move/?utm_source=chatgpt.com"
},
{
"index": null,
"title": "检方称：前大学足球运动员被指控用刀和高尔夫球杆杀害兄弟和家猫",
"type": "url_citation",
"url": "https://people.com/princeton-murder-soccer-player-accused-murdering-athlete-brother-11685671?utm_source=chatgpt.com"
},
{
"index": null,
"title": "过于粘人的 8 岁猫咪被送往收容所，因“过于亲昵”而获得数十份领养申请",
"type": "url_citation",
"url": "https://people.com/cat-surrendered-connecticut-shelter-too-affectionate-11684130?utm_source=chatgpt.com"
},
{
"index": null,
"title": "在梅里登发现的被遗弃在雪中的瘦弱猫咪在获救尝试后死亡，官员称",
"type": "url_citation",
"url": "https://www.ctinsider.com/recordjournal/article/meriden-animal-control-cat-neglected-abandoned-20172924.php?utm_source=chatgpt.com"
},
{
"index": null,
"title": "猫证明了妈妈的说法，使用了人类的马桶",
"type": "url_citation",
"url": "https://nypost.com/video/cat-proves-mom-correct-by-using-human-toilet/?utm_source=chatgpt.com"
},
{
"index": null,
"title": "Litter-Robot 3 Connect 评测",
"type": "url_citation",
"url": "https://www.thesprucepets.com/litter-robot-3-connect-review-8780105?utm_source=chatgpt.com"
},
{
"index": null,
"title": "泰勒·斯威夫特最喜欢的猫面临繁殖禁令",
"type": "url_citation",
"url": "https://www.thetimes.co.uk/article/taylor-swifts-favourite-cat-faces-breeding-ban-k32nvf6kv?utm_source=chatgpt.com"
}
],
"text": "以下是一些关于猫的最新新闻报道：\n\n**1. 猫在搬家过程中被困沙发三周后奇迹般幸存**\n\n一只名叫 Sunny-Loo 的猫在 Hansons 一家从华盛顿州搬到科罗拉多州的途中被困在沙发里三周后幸存下来。在搬家过程中失踪后，当家人拆开家具时，她被发现虽然瘦弱但还活着。Sunny-Loo 接受了重症监护，并已与家人团聚。（[nypost.com](https://nypost.com/2025/02/24/us-news/cat-miraculously-survives-3-weeks-trapped-in-sofa-during-familys-cross-country-move/?utm_source=chatgpt.com)）\n\n**2. 男子被指控杀害兄弟和家猫**\n\n前大学足球运动员 Matthew Hertgen 被指控谋杀他的弟弟 Joseph Hertgen，并因涉嫌杀死家猫而被指控虐待动物。事件发生在新泽西州普林斯顿，当局在那里发现了 Joseph 的尸体，上面有创伤迹象。Matthew 面临多项指控，包括一级谋杀。（[people.com](https://people.com/princeton-murder-soccer-player-accused-murdering-athlete-brother-11685671?utm_source=chatgpt.com)）\n\n**3. “过于亲昵”的猫引发领养兴趣**\n\n一只名叫 Ravi 的 8 岁猫咪因“过于亲昵”被送往康涅狄格州的一家收容所。一段展示他故事的 TikTok 视频疯传，获得了超过 1260 万次观看，并收到了 160 多份领养申请。Ravi 现在已经有了领养预约，收容所也因此获得了更多对其其他可领养宠物的关注。（[people.com](https://people.com/cat-surrendered-connecticut-shelter-too-affectionate-11684130?utm_source=chatgpt.com)）\n\n**4. 在雪地里发现的瘦弱猫咪获救尝试后死亡**\n\n一只名叫 Lizzy 的严重被忽视的猫咪在康涅狄格州梅里登的雪堆中被发现被遗弃。尽管进行了救援，Lizzy 仍未幸存。当局正在寻找信息以确定遗弃她的责任人，并悬赏提供线索。（[ctinsider.com](https://www.ctinsider.com/recordjournal/article/meriden-animal-control-cat-neglected-abandoned-20172924.php?utm_source=chatgpt.com)）\n\n**5. 猫使用人类马桶，让家人惊讶**\n\n在英国，一只名叫 Cruise 的猫咪让它的家人惊讶地使用了人类的马桶。尽管她的伴侣和儿子最初表示怀疑，Hayley Bibby 还是拍摄了 Cruise 的如厕习惯的视频，证实了她的说法。现在，这家人通过将马桶盖留起来来适应 Cruise 的偏好。（[nypost.com](https://nypost.com/video/cat-proves-mom-correct-by-using-human-toilet/?utm_source=chatgpt.com)）\n\n**6. Litter-Robot 3 Connect：一款高科技猫砂盆评测**\n\nLitter-Robot 3 Connect 售价 499 美元，为不喜欢铲猫砂的猫主人提供自动清洁解决方案。虽然有效且可减少 50% 的猫砂使用量，但一些用户指出气味控制仍有改进空间。该设备包括夜灯和智能手机应用程序集成等功能。（[thesprucepets.com](https://www.thesprucepets.com/litter-robot-3-connect-review-8780105?utm_source=chatgpt.com)）\n\n**7. 泰勒·斯威夫特最喜欢的猫品种面临繁殖禁令**\n\n由于遗传性健康问题，像泰勒·斯威夫特这样的名人喜欢的苏格兰折耳猫品种可能在英国面临繁殖禁令。这些猫通常因软骨形成缺陷而遭受痛苦的疾病。动物福利委员会已建议禁止繁殖此类猫以防止进一步的健康问题。（[thetimes.co.uk](https://www.thetimes.co.uk/article/taylor-swifts-favourite-cat-faces-breeding-ban-k32nvf6kv?utm_source=chatgpt.com)）\n\n\n# 近期与猫相关的头条新闻：\n- [猫在搬家过程中被困沙发三周后奇迹般幸存](https://nypost.com/2025/02/24/us-news/cat-miraculously-survives-3-weeks-trapped-in-sofa-during-familys-cross-country-move/?utm_source=chatgpt.com)\n- [检方称：前大学足球运动员被指控用刀和高尔夫球杆杀害兄弟和家猫](https://people.com/princeton-murder-soccer-player-accused-murdering-athlete-brother-11685671?utm_source=chatgpt.com)\n- [过于粘人的 8 岁猫咪被送往收容所，因“过于亲昵”而获得数十份领养申请](https://people.com/cat-surrendered-connecticut-shelter-too-affectionate-11684130?utm_source=chatgpt.com)\n ",
"type": "output_text",
"logprobs": null
}
],
"role": "assistant",
"type": "message"
}
],
"temperature": 1.0,
"tool_choice": "auto",
"tools": [
{
"type": "web_search",
"location": null,
"sites": null
}
],
"top_p": 1.0,
"max_completion_tokens": null,
"previous_response_id": null,
"reasoning_effort": null,
"text": {
"format": {
"type": "text"
},
"stop": null
},
"top_logprobs": null,
"truncation": "disabled",
"usage": {
"completion_tokens": null,
"prompt_tokens": null,
"total_tokens": 1370,
"completion_tokens_details": null,
"prompt_tokens_details": null
}
}
在上面的示例中，我们可以使用 web_search 工具来搜索与图像相关的网络新闻，而无需像使用 Chat Completions API 那样进行多次往返。
使用 Responses API 🔥 单个 API 调用即可处理：
✅ 使用多模态输入分析给定图像。
✅ 通过 web_search 托管工具执行网络搜索
✅ 总结结果。
相比之下，使用 Chat Completions API 需要多个步骤，每个步骤都需要与 API 进行一次往返：
1️⃣ 上传图像并获取分析 → 1 次请求
2️⃣ 提取信息，调用外部网络搜索 → 手动步骤 + 工具执行
3️⃣ 将工具结果重新提交以进行摘要 → 另一次请求
请参阅以下图表以进行并排可视化比较！
我们非常期待您尝试 Responses API，看看它如何简化您的代码，并使构建复杂、多模态、工具增强的交互更加容易！