Responses API 是与OpenAI模型交互的新方式，旨在比之前的API更简单灵活。它让构建高级AI应用变得容易，这些应用可以使用多种工具、处理多轮对话，并处理不同类型的数据（不仅仅是文本）。
与旧版API不同——例如主要针对文本构建的Chat Completions，或需要大量设置的Assistants API——Responses 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="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为您维护上下文的一个优势是，您可以在任何时间点分叉响应，并从该点继续对话。
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工具将网络搜索结果整合到响应中的示例。
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 原生支持文本、图像和音频多种模态。通过将所有这些功能整合在一起，我们可以通过一次API调用，利用responses 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
}
}
在上面的示例中，我们能够通过一次API调用使用web_search工具搜索与图片相关的新闻，而如果使用Chat Completions API则需要多次往返请求。
通过响应API 🔥 一次API调用即可处理：
✅ 使用多模态输入分析给定图像。
✅ 通过托管的web_search工具执行网络搜索
✅ 总结结果。
相比之下，使用Chat Completions API需要多个步骤，每个步骤都需要往返API一次：
1️⃣ 上传图片并获取分析 → 1次请求
2️⃣ 提取信息，调用外部网络搜索 → 手动步骤 + 工具执行
3️⃣ 重新提交工具结果进行汇总 → 另一个请求
请查看以下图表进行直观的对比！
我们非常期待您尝试使用Responses API，看看它如何简化您的代码，让构建复杂的多模态工具增强交互变得更加容易！