Responses API 是一个新的 API，它在使用我们的 API 时侧重于更高的简洁性和更强的表达性。它专为多种工具、多轮对话和多种模态而设计，这与当前的 API 不同，后者要么将这些功能附加到主要为文本输入和输出（聊天补全）而设计的 API 上，要么需要大量引导才能执行简单的操作（助手 API）。
在这里，我将向您展示 Responses API 提供的一些新功能，并在最后将其整合在一起。responses 解决了我们当前 API 集中的许多用户痛点。在使用补全 API 的过程中，我们发现人们想要：
随着模型开始发展更长期的推理和思考能力，用户将需要异步友好且有状态的原语。Response 解决了这个问题。
从设计上来说，从表面上看，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="tell me a joke",
)
print(response.output[0].content[0].text)Why did the scarecrow win an award? Because he was outstanding in his field!
Response API 的一个关键特性是它是有状态的。这意味着您不必自己管理对话的状态，API 会为您处理。例如，您可以随时检索响应，它将包含完整的对话历史记录。
fetched_response = client.responses.retrieve(
response_id=response.id)
print(fetched_response.output[0].content[0].text)
Why did the scarecrow win an award? Because he was outstanding in his field!
您可以通过参考之前的响应来继续对话。
response_two = client.responses.create(
model="gpt-4o-mini",
input="tell me another",
previous_response_id=response.id
)
print(response_two.output[0].content[0].text)Why don't skeletons fight each other? They don't have the guts!
您当然可以自己管理上下文。但是，OpenAI 为您维护上下文的一个好处是，您可以随时fork响应，并从该点继续对话。
response_two_forked = client.responses.create(
model="gpt-4o-mini",
input="I didn't like that joke, tell me another and tell me the difference between the two jokes",
previous_response_id=response.id # Forking and continuing from the first response
)
output_text = response_two_forked.output[0].content[0].text
print(output_text)Sure! Here’s another joke: Why don’t scientists trust atoms? Because they make up everything! **Difference:** The first joke plays on a pun involving "outstanding" in a literal sense versus being exceptional, while the second joke relies on a play on words about atoms "making up" matter versus fabricating stories. Each joke uses wordplay, but they target different concepts (farming vs. science).
Responses API 的另一个好处是，它增加了对托管工具（如 file_search 和 web_search）的支持。无需手动调用工具，只需传入工具，API 就会决定使用哪个工具并使用它。
这是一个使用 web_search 工具将网络搜索结果整合到响应中的示例。您可能已经熟悉 ChatGPT 如何搜索网络。现在您也可以构建类似的体验！网络搜索工具使用 OpenAI Index，它是 ChatGPT 中网络搜索的驱动力，并且已经针对聊天应用程序进行了优化。
response = client.responses.create(
model="gpt-4o", # or another supported model
input="What's the latest news about 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": "Huawei improves AI chip production in boost for China's tech goals",
"type": "url_citation",
"url": "https://www.ft.com/content/f46b7f6d-62ed-4b64-8ad7-2417e5ab34f6?utm_source=chatgpt.com"
},
{
"index": null,
"title": "Apple cheers Trump with $500bn US investment plan; more losses on Wall Street - as it happened",
"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": "Microsoft axes data center leases as DeepSeek casts doubt on massive AI spend: report",
"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": "Alibaba Plans to Invest $52B in AI, Cloud Over Next Three Years",
"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": "JPMorgan Unit Backs Albert Invent at a $270 Million Valuation",
"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": "As of February 25, 2025, several significant developments have emerged in the field of artificial intelligence (AI):\n\n**Huawei's Advancements in AI Chip Production**\n\nHuawei has notably enhanced its AI chip production capabilities, increasing the yield rate of its Ascend 910C processors from 20% to nearly 40%. This improvement has rendered the production line profitable for the first time and is pivotal for China's ambition to achieve self-sufficiency in advanced semiconductors. Despite these strides, Nvidia continues to dominate the AI chip market in China, attributed to its user-friendly software and widespread adoption. Huawei aims to further elevate its yield rate to 60% and plans to produce 100,000 Ascend 910C processors and 300,000 910B chips in 2025. ([ft.com](https://www.ft.com/content/f46b7f6d-62ed-4b64-8ad7-2417e5ab34f6?utm_source=chatgpt.com))\n\n**Apple's $500 Billion U.S. Investment Plan**\n\nApple has unveiled a substantial $500 billion investment strategy in the United States over the next four years. This plan encompasses the creation of 20,000 new jobs and the establishment of a major facility in Texas dedicated to manufacturing artificial intelligence servers. President Donald Trump has lauded this initiative, viewing it as a testament to the confidence in his administration. Concurrently, Wall Street has experienced further losses due to concerns over a potential economic slowdown, exacerbated by tariffs. ([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**Microsoft Adjusts AI Data Center Investments**\n\nMicrosoft has canceled leases on U.S. data centers totaling several hundred megawatts, potentially affecting two large centers. This decision is reportedly linked to concerns about oversupply, following claims by Chinese competitor DeepSeek of developing a generative chatbot more efficiently than U.S. companies. Analysts suggest that Microsoft might be reallocating funds or responding to OpenAI's shift to Oracle for a $500 billion project. Despite being a leading AI investor with planned expenditures of $80 billion this year, Microsoft appears to be scaling back on massive spending initiatives, allowing significant data center agreements to lapse and citing facility and power delays. ([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**Alibaba's $52 Billion Investment in AI and Cloud Infrastructure**\n\nAlibaba Group has announced plans to invest over $52 billion in artificial intelligence and cloud infrastructure over the next three years, surpassing its total investment in these areas over the past decade. This strategic move underscores Alibaba's commitment to AI-driven growth and reinforces its position as a leading global cloud provider. Following this announcement, Alibaba's U.S.-listed shares experienced a 3% drop in premarket trading. Analysts view this investment as aligning with market expectations and indicative of Alibaba Cloud's significant capital expenditure compared to peers. ([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**JPMorgan's Investment in AI-Driven Chemical Development**\n\nJPMorgan Chase's private investment arm has led a $20 million growth investment in Albert Invent, an AI-driven chemical development platform, valuing the company at $270 million. This funding will enable Albert Invent to expand globally and increase its workforce from 120 to over 200 employees by the end of the year. The company assists chemists in developing new formulations and materials, significantly accelerating chemical experiments. For instance, Albert's platform can simulate 100,000 experiments in 10 minutes for clients like Nouryon Chemicals. ([wsj.com](https://www.wsj.com/articles/jpmorgan-unit-backs-albert-invent-at-a-270-million-valuation-1ab03c96?utm_source=chatgpt.com))\n\nThese developments reflect the dynamic and rapidly evolving landscape of AI, with major corporations and financial institutions making significant investments to advance technology and infrastructure in this sector.\n\n\n# Key AI Developments as of February 25, 2025:\n- [Huawei improves AI chip production in boost for China's tech goals](https://www.ft.com/content/f46b7f6d-62ed-4b64-8ad7-2417e5ab34f6?utm_source=chatgpt.com)\n- [Apple cheers Trump with $500bn US investment plan; more losses on Wall Street - as it happened](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- [Microsoft axes data center leases as DeepSeek casts doubt on massive AI spend: report](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":
"Come up with keywords related to the image, and search on the web using the search tool for any news related to the keywords"
", summarize the findings and cite the sources."},
{"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": "Based on the image of a cat, some relevant keywords could be:\n\n- Cat\n- Feline\n- Pet\n- Animal care\n- Cat behavior\n\nI'll search for recent news related to these keywords.",
"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": "Cat miraculously survives 3 weeks trapped in sofa during family's cross-country move",
"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": "Ex-College Soccer Player Accused of Killing Fellow Athlete Brother, Cat Using Knife, Golf Club: Prosecutors",
"type": "url_citation",
"url": "https://people.com/princeton-murder-soccer-player-accused-murdering-athlete-brother-11685671?utm_source=chatgpt.com"
},
{
"index": null,
"title": "Cuddly 8-Year-Old Cat Surrendered to Shelter for Being 'Too Affectionate' Inspires Dozens of Adoption Applications",
"type": "url_citation",
"url": "https://people.com/cat-surrendered-connecticut-shelter-too-affectionate-11684130?utm_source=chatgpt.com"
},
{
"index": null,
"title": "Emaciated cat found in Meriden abandoned in snow dies after rescue attempt, officials say",
"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": "Cat proves mom correct by using human toilet",
"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 Review",
"type": "url_citation",
"url": "https://www.thesprucepets.com/litter-robot-3-connect-review-8780105?utm_source=chatgpt.com"
},
{
"index": null,
"title": "Taylor Swift's favourite cat faces breeding ban",
"type": "url_citation",
"url": "https://www.thetimes.co.uk/article/taylor-swifts-favourite-cat-faces-breeding-ban-k32nvf6kv?utm_source=chatgpt.com"
}
],
"text": "Here are some recent news stories related to cats:\n\n**1. Cat Survives Three Weeks Trapped in Sofa During Move**\n\nA cat named Sunny-Loo survived three weeks trapped inside a sofa during the Hansons' move from Washington state to Colorado. After disappearing during the move, she was discovered emaciated but alive when the family unpacked their furniture. Sunny-Loo received intensive care and has since been reunited with her family. ([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. Man Charged with Killing Brother and Family Cat**\n\nMatthew Hertgen, a former college soccer player, has been charged with the murder of his younger brother, Joseph Hertgen, and animal cruelty for allegedly killing the family cat. The incident occurred in Princeton, New Jersey, where authorities found Joseph's body with signs of trauma. Matthew faces multiple charges, including first-degree murder. ([people.com](https://people.com/princeton-murder-soccer-player-accused-murdering-athlete-brother-11685671?utm_source=chatgpt.com))\n\n**3. \"Too Affectionate\" Cat Sparks Adoption Interest**\n\nAn 8-year-old cat named Ravi was surrendered to a Connecticut shelter for being \"too affectionate.\" A TikTok video highlighting his story went viral, amassing over 12.6 million views and leading to more than 160 adoption applications. Ravi now has an adoption appointment, and the shelter has gained increased attention for its other adoptable pets. ([people.com](https://people.com/cat-surrendered-connecticut-shelter-too-affectionate-11684130?utm_source=chatgpt.com))\n\n**4. Emaciated Cat Found in Snow Dies After Rescue Attempt**\n\nA severely neglected cat named Lizzy was found abandoned in a snowbank in Meriden, Connecticut. Despite rescue efforts, Lizzy did not survive. Authorities are seeking information to identify the person responsible for her abandonment, with a reward offered for leads. ([ctinsider.com](https://www.ctinsider.com/recordjournal/article/meriden-animal-control-cat-neglected-abandoned-20172924.php?utm_source=chatgpt.com))\n\n**5. Cat Uses Human Toilet, Surprising Family**\n\nIn the UK, a cat named Cruise surprised his family by using a human toilet. Despite initial skepticism from her partner and son, Hayley Bibby captured footage of Cruise's bathroom habits, validating her claims. The family now accommodates Cruise's preference by leaving the toilet seat up. ([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: A High-Tech Litter Box Review**\n\nThe Litter-Robot 3 Connect, priced at $499, offers a self-cleaning solution for cat owners averse to scooping litter. While effective and reducing litter usage by 50%, some users note that odor prevention could be improved. The device includes features like a night light and smartphone app integration. ([thesprucepets.com](https://www.thesprucepets.com/litter-robot-3-connect-review-8780105?utm_source=chatgpt.com))\n\n**7. Taylor Swift's Favorite Cat Breed Faces Breeding Ban**\n\nThe Scottish Fold cat breed, favored by celebrities like Taylor Swift, may face a breeding ban in Britain due to inheritable health issues. These cats often suffer from painful conditions caused by defective cartilage formation. The Animal Welfare Committee has recommended prohibiting the breeding of such cats to prevent further health problems. ([thetimes.co.uk](https://www.thetimes.co.uk/article/taylor-swifts-favourite-cat-faces-breeding-ban-k32nvf6kv?utm_source=chatgpt.com))\n\n\n# Recent Cat-Related News Stories:\n- [Cat miraculously survives 3 weeks trapped in sofa during family's cross-country move](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- [Ex-College Soccer Player Accused of Killing Fellow Athlete Brother, Cat Using Knife, Golf Club: Prosecutors](https://people.com/princeton-murder-soccer-player-accused-murdering-athlete-brother-11685671?utm_source=chatgpt.com)\n- [Cuddly 8-Year-Old Cat Surrendered to Shelter for Being 'Too Affectionate' Inspires Dozens of Adoption Applications](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 工具搜索与图像相关的新闻，只需一次 API 调用，而不是如果使用 Chat Completions API 则需要的多次往返。
使用 responses API 🔥，单次 API 调用即可处理：
✅ 使用多模态输入分析给定的图像。
✅ 通过 web_search 托管工具执行网络搜索
✅ 总结结果。
相比之下，使用 Chat Completions API 将需要多个步骤，每个步骤都需要往返 API
1️⃣ 上传图像并获取分析 → 1 个请求
2️⃣ 提取信息，调用外部网络搜索 → 手动步骤 + 工具执行
3️⃣ 重新提交工具结果以进行总结 → 另一个请求
请参阅下图以进行并排可视化比较！
我们非常激动地邀请您试用 Responses API，看看它如何简化您的代码，并使构建复杂、多模态、工具增强的交互变得更容易！