Định dạng phản hồi OpenAI (Phản hồi)
Tài liệu chính thức
📝 Giới thiệu
Giao diện phản hồi mô hình tiên tiến nhất của OpenAI. Hỗ trợ nhập văn bản và hình ảnh cũng như xuất văn bản. Tạo các tương tác có trạng thái với mô hình, sử dụng đầu ra của phản hồi trước đó làm đầu vào. Mở rộng khả năng của mô hình bằng các công cụ tích hợp sẵn như tìm kiếm tệp, tìm kiếm trên web và sử dụng máy tính. Sử dụng chức năng gọi hàm để cho phép mô hình truy cập vào hệ thống và dữ liệu bên ngoài.
Các hướng dẫn liên quan có thể được tìm thấy trên trang web chính thức của OpenAI: Phản hồi
💡 Yêu cầu Ví dụ
Trả lời văn bản cơ bản ✅
curl https://88api.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "gpt-4.1",
"input": "Tell a three-sentence bedtime story about unicorns。"
}'Response Example:
{
"id": "resp_67ccd2bed1ec8190b14f964abc0542670bb6a6b452d3795b",
"object": "response",
"created_at": 1741476542,
"status": "completed",
"error": null,
"incomplete_details": null,
"instructions": null,
"max_output_tokens": null,
"model": "gpt-4.1",
"output": [
{
"type": "message",
"id": "msg_67ccd2bf17f0819081ff3bb2cf6508e60bb6a6b452d3795b",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "under a quiet moonlit night,A unicorn named Lumina discovers a hidden pool reflecting stars。when she dipped her horn into the water,The pool starts flashing,Revealing the path to a magical world of endless night skies。full of curiosity,Lumina makes a wish for everyone who dreams,Hope they find their own hidden magic,when she looks back,Her hoofprints sparkle like stardust。",
"annotations": []
}
]
}
],
"parallel_tool_calls": true,
"previous_response_id": null,
"reasoning": {
"effort": null,
"summary": null
},
"store": true,
"temperature": 1.0,
"text": {
"format": {
"type": "text"
}
},
"tool_choice": "auto",
"tools": [],
"top_p": 1.0,
"truncation": "disabled",
"usage": {
"input_tokens": 36,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens": 87,
"output_tokens_details": {
"reasoning_tokens": 0
},
"total_tokens": 123
},
"user": null,
"metadata": {}
}Phản hồi phân tích hình ảnh ✅
curl https://88api.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "gpt-4.1",
"input": [
{
"role": "user",
"content": [
{"type": "input_text", "text": "Describe what's in this image"},
{
"type": "input_image",
"image_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg"
}
]
}
]
}'Response Example:
{
"id": "resp_67ccd3a9da748190baa7f1570fe91ac604becb25c45c1d41",
"object": "response",
"created_at": 1741476777,
"status": "completed",
"error": null,
"incomplete_details": null,
"instructions": null,
"max_output_tokens": null,
"model": "gpt-4.1",
"output": [
{
"type": "message",
"id": "msg_67ccd3acc8d48190a77525dc6de64b4104becb25c45c1d41",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "This image shows a wooden boardwalk or trail through lush green meadows,Above is a blue sky dotted with a few clouds。The scene presents a tranquil natural area,May be a park or nature reserve。There are trees and bushes in the background。The entire landscape displays a harmonious natural environment,Boardwalks provide visitors with a path through wetlands or grasslands without impacting the surrounding ecosystem。",
"annotations": []
}
]
}
],
"parallel_tool_calls": true,
"previous_response_id": null,
"reasoning": {
"effort": null,
"summary": null
},
"store": true,
"temperature": 1.0,
"text": {
"format": {
"type": "text"
}
},
"tool_choice": "auto",
"tools": [],
"top_p": 1.0,
"truncation": "disabled",
"usage": {
"input_tokens": 328,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens": 52,
"output_tokens_details": {
"reasoning_tokens": 0
},
"total_tokens": 380
},
"user": null,
"metadata": {}
}Công cụ tìm kiếm trên web ✅
curl https://88api.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "gpt-4.1",
"tools": [{ "type": "web_search_preview" }],
"input": "What’s the positive news today??"
}'Response Example:
{
"id": "resp_67ccf18ef5fc8190b16dbee19bc54e5f087bb177ab789d5c",
"object": "response",
"created_at": 1741484430,
"status": "completed",
"error": null,
"incomplete_details": null,
"instructions": null,
"max_output_tokens": null,
"model": "gpt-4.1",
"output": [
{
"type": "web_search_call",
"id": "ws_67ccf18f64008190a39b619f4c8455ef087bb177ab789d5c",
"status": "completed"
},
{
"type": "message",
"id": "msg_67ccf190ca3881909d433c50b1f6357e087bb177ab789d5c",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "As of today,2025Year3moon9day,One positive piece of news worth paying attention to is that Chinese scientists have made a major breakthrough in the field of renewable energy,Successfully developed a new type of high-efficiency solar cell,Conversion rates hit record highs35%,This may greatly promote the popularization and application of clean energy。This technology is expected to reduce the cost of solar power generation by approx.40%,Providing new solutions for reducing global carbon emissions。",
"annotations": [
{
"type": "url_citation",
"start_index": 42,
"end_index": 100,
"url": "https://example.com/renewable-energy-breakthrough/?utm_source=chatgpt.com",
"title": "Chinese scientists make major breakthrough in renewable energy"
},
{
"type": "url_citation",
"start_index": 101,
"end_index": 150,
"url": "https://example.com/solar-cell-efficiency-record/?utm_source=chatgpt.com",
"title": "New high-efficiency solar cell sets record conversion rate"
},
{
"type": "url_citation",
"start_index": 151,
"end_index": 200,
"url": "https://example.com/clean-energy-cost-reduction/?utm_source=chatgpt.com",
"title": "Solar power generation costs expected to decrease40%"
}
]
}
]
}
],
"parallel_tool_calls": true,
"previous_response_id": null,
"reasoning": {
"effort": null,
"summary": null
},
"store": true,
"temperature": 1.0,
"text": {
"format": {
"type": "text"
}
},
"tool_choice": "auto",
"tools": [
{
"type": "web_search_preview",
"domains": [],
"search_context_size": "medium",
"user_location": {
"type": "approximate",
"city": null,
"country": "US",
"region": null,
"timezone": null
}
}
],
"top_p": 1.0,
"truncation": "disabled",
"usage": {
"input_tokens": 328,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens": 356,
"output_tokens_details": {
"reasoning_tokens": 0
},
"total_tokens": 684
},
"user": null,
"metadata": {}
}Công cụ tìm kiếm tệp ✅
curl https://88api.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "gpt-4.1",
"tools": [{
"type": "file_search",
"vector_store_ids": ["vs_1234567890"],
"max_num_results": 20
}],
"input": "What are the characteristics and attributes of the ancient brown dragon??"
}'Response Example:
{
"id": "resp_67ccf4c55fc48190b71bd0463ad3306d09504fb6872380d7",
"object": "response",
"created_at": 1741485253,
"status": "completed",
"error": null,
"incomplete_details": null,
"instructions": null,
"max_output_tokens": null,
"model": "gpt-4.1",
"output": [
{
"type": "file_search_call",
"id": "fs_67ccf4c63cd08190887ef6464ba5681609504fb6872380d7",
"status": "completed",
"queries": ["Ancient Brown Dragon Characteristics and Properties"],
"results": null
},
{
"type": "message",
"id": "msg_67ccf4c93e5c81909d595b369351a9d309504fb6872380d7",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "According to information,Ancient Brown Dragons have the following traits and attributes:\n\n1. physical characteristics:Ancient brown dragon was huge,Body length up to25-30rice,Wingspan approx.35rice。Their scales are dark brown to copper in color,It becomes darker with age。The head has characteristic horns and spines,Strong jaw,Good for tearing apart prey。\n\n2. ability:They can spit powerful acid,Causes severe corrosive damage to target。Ancient brown dragons also had excellent digging abilities,Often dig complex nest systems in deserts or mountains。\n\n3. intelligence:Considered the most cunning and patient breed among dragons,Extremely high intelligence,Proficient in multiple languages,and have complex tactical thinking。\n\n4. habitat:Mainly inhabit arid mountain and desert areas,Like hot and dry environment。\n\n5. treasure:Ancient Brown Dragons Known for Their Huge Treasures,Particularly fond of collecting copper coins、Ruby and Fire Magic Items。\n\n6. life:One of the longest lifespans of all dragon species,Liveable2000-2500Year,Their strength and magical abilities increase with age.。\n\n7. character:Extremely territorial,Irritable and irritable personality,Show no mercy to intruders,But he is also known for his rare patience,Waiting for centuries for revenge。",
"annotations": [
{
"type": "file_citation",
"index": 80,
"file_id": "file-4wDz5b167pAf72nx1h9eiN",
"filename": "dragons.pdf"
},
{
"type": "file_citation",
"index": 233,
"file_id": "file-4wDz5b167pAf72nx1h9eiN",
"filename": "dragons.pdf"
},
{
"type": "file_citation",
"index": 345,
"file_id": "file-4wDz5b167pAf72nx1h9eiN",
"filename": "dragons.pdf"
},
{
"type": "file_citation",
"index": 420,
"file_id": "file-4wDz5b167pAf72nx1h9eiN",
"filename": "dragons.pdf"
},
{
"type": "file_citation",
"index": 520,
"file_id": "file-4wDz5b167pAf72nx1h9eiN",
"filename": "dragons.pdf"
},
{
"type": "file_citation",
"index": 580,
"file_id": "file-4wDz5b167pAf72nx1h9eiN",
"filename": "dragons.pdf"
},
{
"type": "file_citation",
"index": 655,
"file_id": "file-4wDz5b167pAf72nx1h9eiN",
"filename": "dragons.pdf"
},
{
"type": "file_citation",
"index": 781,
"file_id": "file-4wDz5b167pAf72nx1h9eiN",
"filename": "dragons.pdf"
}
]
}
]
}
],
"parallel_tool_calls": true,
"previous_response_id": null,
"reasoning": {
"effort": null,
"summary": null
},
"store": true,
"temperature": 1.0,
"text": {
"format": {
"type": "text"
}
},
"tool_choice": "auto",
"tools": [
{
"type": "file_search",
"filters": null,
"max_num_results": 20,
"ranking_options": {
"ranker": "auto",
"score_threshold": 0.0
},
"vector_store_ids": ["vs_1234567890"]
}
],
"top_p": 1.0,
"truncation": "disabled",
"usage": {
"input_tokens": 18307,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens": 348,
"output_tokens_details": {
"reasoning_tokens": 0
},
"total_tokens": 18655
},
"user": null,
"metadata": {}
}Phản hồi trực tuyến ✅
curl https://88api.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "gpt-4.1",
"instructions": "you are a helpful assistant。",
"input": "Hello!",
"stream": true
}'Streaming Response Example:
event: response.created
data: {"type":"response.created","response":{"id":"resp_67c9fdcecf488190bdd9a0409de3a1ec07b8b0ad4e5eb654","object":"response","created_at":1741290958,"status":"in_progress","error":null,"incomplete_details":null,"instructions":"you are a helpful assistant。","max_output_tokens":null,"model":"gpt-4.1-2025-04-14","output":[],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_p":1.0,"truncation":"disabled","usage":null,"user":null,"metadata":{}}}
event: response.in_progress
data: {"type":"response.in_progress","response":{"id":"resp_67c9fdcecf488190bdd9a0409de3a1ec07b8b0ad4e5eb654","object":"response","created_at":1741290958,"status":"in_progress","error":null,"incomplete_details":null,"instructions":"you are a helpful assistant。","max_output_tokens":null,"model":"gpt-4.1-2025-04-14","output":[],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_p":1.0,"truncation":"disabled","usage":null,"user":null,"metadata":{}}}
event: response.output_item.added
data: {"type":"response.output_item.added","output_index":0,"item":{"id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","type":"message","status":"in_progress","role":"assistant","content":[]}}
event: response.content_part.added
data: {"type":"response.content_part.added","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"part":{"type":"output_text","text":"","annotations":[]}}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"delta":"Hello"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"delta":"!"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"delta":" I"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"delta":"able"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"delta":"for"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"delta":"you"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"delta":"supply"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"delta":"What"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"delta":"help"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"delta":"?"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"delta":"?"}
event: response.output_text.done
data: {"type":"response.output_text.done","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"text":"Hello! How can I help you??"}
event: response.content_part.done
data: {"type":"response.content_part.done","item_id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","output_index":0,"content_index":0,"part":{"type":"output_text","text":"Hello! How can I help you??","annotations":[]}}
event: response.output_item.done
data: {"type":"response.output_item.done","output_index":0,"item":{"id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","type":"message","status":"completed","role":"assistant","content":[{"type":"output_text","text":"Hello! How can I help you??","annotations":[]}]}}
event: response.completed
data: {"type":"response.completed","response":{"id":"resp_67c9fdcecf488190bdd9a0409de3a1ec07b8b0ad4e5eb654","object":"response","created_at":1741290958,"status":"completed","error":null,"incomplete_details":null,"instructions":"you are a helpful assistant。","max_output_tokens":null,"model":"gpt-4.1-2025-04-14","output":[{"id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","type":"message","status":"completed","role":"assistant","content":[{"type":"output_text","text":"Hello! How can I help you??","annotations":[]}]}],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_p":1.0,"truncation":"disabled","usage":{"input_tokens":37,"output_tokens":11,"output_tokens_details":{"reasoning_tokens":0},"total_tokens":48},"user":null,"metadata":{}}}Gọi hàm ✅
curl https://88api.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "gpt-4.1",
"input": "What's the weather like today in Boston??",
"tools": [
{
"type": "function",
"name": "get_current_weather",
"description": "Get the current weather for a specified location",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "city and state,For example San Francisco, CA"
},
"unit": {
"type": "string",
"enum": ["celsius", "fahrenheit"]
}
},
"required": ["location", "unit"]
}
}
],
"tool_choice": "auto"
}'Response Example:
{
"id": "resp_67ca09c5efe0819096d0511c92b8c890096610f474011cc0",
"object": "response",
"created_at": 1741294021,
"status": "completed",
"error": null,
"incomplete_details": null,
"instructions": null,
"max_output_tokens": null,
"model": "gpt-4.1-2025-04-14",
"output": [
{
"type": "function_call",
"id": "fc_67ca09c6bedc8190a7abfec07b1a1332096610f474011cc0",
"call_id": "call_unLAR8MvFNptuiZK6K6HCy5k",
"name": "get_current_weather",
"arguments": "{\"location\":\"boston, MA\",\"unit\":\"celsius\"}",
"status": "completed"
}
],
"parallel_tool_calls": true,
"previous_response_id": null,
"reasoning": {
"effort": null,
"summary": null
},
"store": true,
"temperature": 1.0,
"text": {
"format": {
"type": "text"
}
},
"tool_choice": "auto",
"tools": [
{
"type": "function",
"description": "Get the current weather for a specified location",
"name": "get_current_weather",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "city and state,For example San Francisco, CA"
},
"unit": {
"type": "string",
"enum": ["celsius", "fahrenheit"]
}
},
"required": ["location", "unit"]
},
"strict": true
}
],
"top_p": 1.0,
"truncation": "disabled",
"usage": {
"input_tokens": 291,
"output_tokens": 23,
"output_tokens_details": {
"reasoning_tokens": 0
},
"total_tokens": 314
},
"user": null,
"metadata": {}
}Khả năng suy luận ✅
curl https://88api.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "o3-mini",
"input": "How much wood can a woodpecker peck??",
"reasoning": {
"effort": "high"
}
}'Response Example:
{
"id": "resp_67ccd7eca01881908ff0b5146584e408072912b2993db808",
"object": "response",
"created_at": 1741477868,
"status": "completed",
"error": null,
"incomplete_details": null,
"instructions": null,
"max_output_tokens": null,
"model": "o1-2024-12-17",
"output": [
{
"type": "message",
"id": "msg_67ccd7f7b5848190a6f3e95d809f6b44072912b2993db808",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "This is a tongue twister derived from English"How much wood would a woodchuck chuck if a woodchuck could chuck wood"question。in reality,woodpecker(woodpecker)and groundhog(woodchuck)are different animals,And prairie dogs don’t actually"peck(chuck)"wood。\n\nfrom a scientific perspective,Woodpeckers do peck trees every day in search of food、Build a lair or communicate。On average, a woodpecker may peck about a tree per day.8000-12000Second-rate,Depends on species and specific purpose。If we convert this to the amount of wood,Assuming that each peck removes approx.0.1-0.2cubic centimeters of wood,So a woodpecker could theoretically remove about800-2400cubic centimeters of wood。\n\nHowever,Woodpeckers peck wood primarily for food and nesting,rather than simply removing the wood,So this calculation is just an interesting theoretical estimate。",
"annotations": []
}
]
}
],
"parallel_tool_calls": true,
"previous_response_id": null,
"reasoning": {
"effort": "high",
"summary": null
},
"store": true,
"temperature": 1.0,
"text": {
"format": {
"type": "text"
}
},
"tool_choice": "auto",
"tools": [],
"top_p": 1.0,
"truncation": "disabled",
"usage": {
"input_tokens": 81,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens": 1035,
"output_tokens_details": {
"reasoning_tokens": 832
},
"total_tokens": 1116
},
"user": null,
"metadata": {}
}📮 Yêu cầu
Điểm cuối
POST /v1/responsesTạo một phản hồi mô hình. Cung cấp đầu vào văn bản hoặc hình ảnh để tạo đầu ra văn bản hoặc JSON. Cho phép mô hình gọi mã tùy chỉnh của riêng bạn hoặc sử dụng các công cụ tích hợp sẵn (chẳng hạn như tìm kiếm trên web hoặc tìm kiếm tệp) để sử dụng dữ liệu của riêng bạn làm đầu vào cho phản hồi của mô hình.
Phương thức xác thực
Bao gồm nội dung sau trong tiêu đề yêu cầu để xác thực khóa API:
Authorization: Bearer $API_KEYTrong đó $API_KEY là khóa API của bạn.
Thông số nội dung yêu cầu
đầu vào
Type: String or array
Required: Yes
Văn bản, hình ảnh hoặc tệp đầu vào được cung cấp cho mô hình để tạo phản hồi.
Các loại có thể có
| Loại | Mô tả |
|---|---|
| Chuỗi | Nhập văn bản, tương đương với nhập văn bản với vai trò người dùng |
| Mảng các mục đầu vào | Danh sách chứa một hoặc nhiều mục đầu vào thuộc các loại nội dung khác nhau |
Đối tượng thông báo đầu vào
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| nội dung | Chuỗi hoặc mảng | Có | Đầu vào văn bản, hình ảnh hoặc âm thanh được cung cấp cho mô hình để tạo ra phản hồi. Cũng có thể bao gồm các câu trả lời của trợ lý trước đó |
| vai trò | Chuỗi | Có | Vai trò của thông điệp đầu vào Các giá trị có thể có: user, assistant, system, hoặc developer |
| gõ | Chuỗi | Không | Loại thông báo đầu vào, luôn là message |
Loại mục nội dung
Nhập văn bản
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| văn bản | Chuỗi | Có | Kiểu nhập văn bản được cung cấp cho mô hình |
| gõ | Chuỗi | Có | Loại mục đầu vào, luôn là input_text |
Nhập hình ảnh
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| chi tiết | Chuỗi | Có | Mức độ chi tiết của hình ảnh được gửi đến mô hình. Các giá trị có thể: high, low, hoặc auto. Mặc định là auto |
| gõ | Chuỗi | Có | Loại mục đầu vào, luôn là input_image |
| tập tin_id | Chuỗi | Không | ID tệp sẽ được gửi đến mô hình |
| hình ảnh_url | Chuỗi | Không | URL hình ảnh sẽ được gửi đến mô hình. Có thể là URL đầy đủ hoặc hình ảnh được mã hóa base64 trong URL dữ liệu |
Nhập tập tin
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| gõ | Chuỗi | Có | Loại mục đầu vào, luôn là input_file |
| file_data | Chuỗi | Không | Nội dung file cần gửi tới mô hình |
| tập tin_id | Chuỗi | Không | ID tệp sẽ được gửi đến mô hình |
| tên tập tin | Chuỗi | Không | Tên tệp sẽ được gửi đến mô hình |
Loại mục đầu ra
Văn bản đầu ra
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| văn bản | Chuỗi | Có | Đầu ra văn bản được tạo bởi mô hình |
| gõ | Chuỗi | Có | Loại mục đầu ra, luôn là output_text |
| chú thích | Mảng | Có | Chú thích cho đầu ra văn bản |
Các loại chú thích
Trích dẫn tập tin:
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| tập tin_id | Chuỗi | Có | ID của tập tin |
| chỉ mục | Số nguyên | Có | Chỉ mục của file trong danh sách file |
| gõ | Chuỗi | Có | Loại trích dẫn của tập tin, luôn là file_citation |
Trích dẫn URL:
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| end_index | Số nguyên | Có | Chỉ mục ký tự cuối cùng của trích dẫn URL trong tin nhắn |
| chỉ mục bắt đầu | Số nguyên | Có | Chỉ mục của ký tự đầu tiên của trích dẫn URL trong tin nhắn |
| tiêu đề | Chuỗi | Có | Tiêu đề của tài nguyên web |
| gõ | Chuỗi | Có | Loại trích dẫn URL, luôn url_citation |
| url | Chuỗi | Có | URL của tài nguyên web |
Đường dẫn tệp:
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| tập tin_id | Chuỗi | Có | ID của tập tin |
| chỉ mục | Số nguyên | Có | Chỉ mục của file trong danh sách file |
| gõ | Chuỗi | Có | Kiểu của đường dẫn tập tin, luôn là file_path |
Phản hồi từ chối
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| từ chối | Chuỗi | Có | Lời giải thích từ chối của người mẫu |
| gõ | Chuỗi | Có | Kiểu từ chối luôn refusal |
Các loại lệnh gọi công cụ
Cuộc gọi công cụ tìm kiếm tệp
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| id | Chuỗi | Có | ID duy nhất cho lệnh gọi công cụ tìm kiếm tệp |
| truy vấn | Mảng | Có | Truy vấn được sử dụng để tìm kiếm tệp |
| trạng thái | Chuỗi | Có | Trạng thái của cuộc gọi công cụ tìm kiếm tập tin. Các giá trị có thể bao gồm: in_progress, searching, incomplete, hoặc failed |
| gõ | Chuỗi | Có | Kiểu gọi của công cụ tìm kiếm tập tin, luôn là file_search_call |
| kết quả | Mảng hoặc null | Không | Kết quả gọi công cụ tìm kiếm file |
Gọi công cụ tìm kiếm trên web
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| id | Chuỗi | Có | ID duy nhất cho lệnh gọi công cụ tìm kiếm trên web |
| trạng thái | Chuỗi | Có | Trạng thái của lệnh gọi công cụ tìm kiếm trên web |
| gõ | Chuỗi | Có | Kiểu gọi của công cụ tìm kiếm trên web, luôn là web_search_call |
Gọi công cụ chức năng
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| lập luận | Chuỗi | Có | Chuỗi đối số JSON được truyền cho hàm |
| gọi_id | Chuỗi | Có | ID duy nhất của lệnh gọi công cụ chức năng do mô hình tạo ra |
| tên | Chuỗi | Có | Tên hàm cần chạy |
| gõ | Chuỗi | Có | Kiểu của lệnh gọi công cụ chức năng, luôn là function_call |
| id | Chuỗi | Không | ID duy nhất cho lệnh gọi công cụ chức năng |
| trạng thái | Chuỗi | Không | Trạng thái của mặt hàng. Các giá trị có thể có: in_progress, completed, hoặc incomplete |
Gọi công cụ máy tính
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| hành động | Đối tượng | Có | Hành động tương tác với máy tính, chẳng hạn như nhấp, kéo, v.v. |
| gọi_id | Chuỗi | Có | Mã định danh được sử dụng khi phản hồi đầu ra lệnh gọi công cụ |
| id | Chuỗi | Có | ID duy nhất cho cuộc gọi máy tính |
| đang chờ xử lý_safety_checks | Mảng | Có | Đang chờ kiểm tra an toàn cho cuộc gọi máy tính |
| trạng thái | Chuỗi | Có | Trạng thái của mặt hàng. Các giá trị có thể có: in_progress, completed, hoặc incomplete |
| gõ | Chuỗi | Có | Kiểu cuộc gọi của máy tính, luôn là computer_call |
Các loại hành động máy tính:
| Loại hoạt động | Mô tả |
|---|---|
| bấm vào | Thao tác click chuột |
| double_click | Thao tác click đúp chuột |
| kéo | Thao tác kéo |
| nhấn phím | Thao tác nhấn phím |
| di chuyển | Thao tác di chuyển chuột |
| ảnh chụp màn hình | Thao tác chụp ảnh màn hình |
| cuộn | Thao tác cuộn |
| gõ | Thao tác nhập văn bản |
| chờ đợi | Chờ hoạt động |
Đầu ra cuộc gọi của công cụ máy tính
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| gọi_id | Chuỗi | Có | ID của lệnh gọi công cụ máy tính đã tạo ra kết quả |
| đầu ra | Đối tượng | Có | Ảnh chụp màn hình máy tính dùng cho công cụ sử dụng máy tính |
| gõ | Chuỗi | Có | Loại đầu ra cuộc gọi của công cụ máy tính, luôn là computer_call_output |
| thừa nhận_safety_checks | Mảng | Không | Kiểm tra an toàn do API báo cáo đã được nhà phát triển xác nhận |
| id | Chuỗi | Không | ID của đầu ra cuộc gọi công cụ máy tính |
| trạng thái | Chuỗi | Không | Trạng thái của thông báo đầu vào. Các giá trị có thể có: in_progress, completed, hoặc incomplete |
Đầu ra cuộc gọi của công cụ chức năng
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| gọi_id | Chuỗi | Có | ID duy nhất của lệnh gọi công cụ chức năng do mô hình tạo ra |
| đầu ra | Chuỗi | Có | Chuỗi JSON của đầu ra lệnh gọi công cụ hàm |
| gõ | Chuỗi | Có | Loại đầu ra lệnh gọi công cụ chức năng, luôn là function_call_output |
| id | Chuỗi | Không | ID duy nhất cho đầu ra lệnh gọi công cụ chức năng |
| trạng thái | Chuỗi | Không | Trạng thái của mặt hàng. Các giá trị có thể có: in_progress, completed, hoặc incomplete |
Lý luận Các mục liên quan
| Tài sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| id | Chuỗi | Có | Mã định danh duy nhất cho nội dung lý luận |
| tóm tắt | Mảng | Có | Nội dung văn bản lý luận |
| gõ | Chuỗi | Có | Loại đối tượng, luôn luôn là reasoning |
| nội dung được mã hóa | Chuỗi hoặc null | Không | Nội dung được mã hóa của mục lý luận - được điền khi tạo phản hồi bằng tham số reasoning.encrypted_content include |
| trạng thái | Chuỗi | Không | Trạng thái của mặt hàng. Các giá trị có thể có: in_progress, completed, hoặc incomplete |
Tóm tắt lý luận:
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| văn bản | Chuỗi | Có | Bản tóm tắt ngắn gọn về lý do được mô hình sử dụng khi tạo phản hồi |
| gõ | Chuỗi | Có | Loại đối tượng, luôn luôn là summary_text |
Tham khảo mặt hàng
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| id | Chuỗi | Có | ID của mục được tham chiếu |
| gõ | Chuỗi | Không | Loại mục được tham chiếu, luôn là item_reference |
người mẫu
Type: String
Required: Yes
ID mẫu được dùng để tạo phản hồi, chẳng hạn như gpt-4.1 hoặc o3. OpenAI cung cấp nhiều mô hình khác nhau với khả năng, đặc điểm hiệu suất và mức giá khác nhau. Vui lòng tham khảo hướng dẫn mô hình để duyệt và so sánh các mô hình có sẵn.
bao gồm
Type: Array or null
Required: No
Chỉ định dữ liệu đầu ra bổ sung để đưa vào phản hồi của mô hình. Các giá trị được hỗ trợ hiện tại bao gồm:
| Giá trị | Mô tả |
|---|---|
file_search_call.results | Bao gồm kết quả tìm kiếm cho các lệnh gọi công cụ tìm kiếm tệp |
message.input_image.image_url | Bao gồm URL hình ảnh trong thông báo đầu vào |
computer_call_output.output.image_url | Bao gồm URL hình ảnh trong đầu ra cuộc gọi máy tính |
reasoning.encrypted_content | Bao gồm phiên bản được mã hóa của mã thông báo lý luận trong đầu ra mục lý luận |
hướng dẫn
Type: String or null
Required: No
Chèn thông báo hệ thống (hoặc nhà phát triển) làm mục đầu tiên trong ngữ cảnh mô hình.
Khi được sử dụng với previous_response_id, các hướng dẫn từ phản hồi trước đó sẽ không được chuyển sang phản hồi tiếp theo. Điều này giúp việc chuyển đổi thông báo hệ thống (nhà phát triển) sang phản hồi mới trở nên đơn giản.
max_output_tokens
Type: Integer or null
Required: No
Giới hạn trên của số lượng mã thông báo có thể được tạo cho phản hồi, bao gồm mã thông báo đầu ra hiển thị và mã thông báo lý luận.
siêu dữ liệu
Type: Object
Required: No
Một tập hợp gồm 16 cặp khóa-giá trị có thể được gắn vào một đối tượng. Điều này hữu ích để lưu trữ thông tin bổ sung về đối tượng ở định dạng có cấu trúc và có thể được truy vấn thông qua API hoặc trang tổng quan.
Khóa là chuỗi có độ dài tối đa 64 ký tự. Giá trị là các chuỗi có độ dài tối đa 512 ký tự.
cuộc gọi_tool_song song
Type: Boolean or null
Required: No
Default Value: true
Liệu mô hình có được phép chạy các lệnh gọi công cụ song song hay không.
previous_response_id
Type: String or null
Required: No
ID duy nhất của phản hồi trước đó của mô hình. Sử dụng tham số này để tạo cuộc hội thoại nhiều lượt. Tìm hiểu thêm về trạng thái hội thoại.
lý luận
Type: Object or null
Required: No
Only applicable to o-series models
Các tùy chọn cấu hình cho mô hình lý luận.
| Tài sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| nỗ lực | Chuỗi hoặc null | Không | Mức độ nỗ lực lý luận. Các giá trị có thể có: low, medium, high. Mặc định là medium. Giảm nỗ lực suy luận có thể tăng tốc độ phản hồi và giảm số lượng mã thông báo được sử dụng để suy luận trong phản hồi |
| tóm tắt | Chuỗi hoặc null | Không | Tóm tắt lý luận được thực hiện bởi mô hình. Điều này rất hữu ích cho việc gỡ lỗi và hiểu quá trình suy luận của mô hình. Các giá trị có thể có: auto, concise, detailed |
| tạo_tóm tắt | Chuỗi hoặc null | Không | Không được dùng nữa: Vui lòng sử dụng summary thay thế. Tóm tắt lý luận được thực hiện bởi mô hình. Các giá trị có thể có: auto, concise, detailed |
cấp_dịch vụ
Type: String or null
Required: No
Default Value: auto
Chỉ định mức độ trễ được sử dụng để xử lý yêu cầu. Tham số này phù hợp với khách hàng đã đăng ký dịch vụ cấp quy mô:
| Giá trị | Mô tả |
|---|---|
auto | Nếu dự án đã bật Cấp Quy mô, hệ thống sẽ sử dụng tín dụng của Cấp Quy mô cho đến khi hết; nếu dự án chưa bật Cấp quy mô, yêu cầu sẽ được xử lý bằng cấp dịch vụ mặc định, có SLA thời gian hoạt động thấp hơn và không đảm bảo độ trễ |
default | Yêu cầu sẽ được xử lý bằng cấp dịch vụ mặc định, có SLA thời gian hoạt động thấp hơn và không đảm bảo độ trễ |
flex | Yêu cầu sẽ được xử lý bằng tầng dịch vụ Xử lý linh hoạt. Tìm hiểu thêm trong tài liệu chính thức |
Khi tham số này không được thiết lập, hành vi mặc định là auto.
Khi tham số này được thiết lập, phần thân phản hồi sẽ bao gồm service_tier được sử dụng.
cửa hàng
Type: Boolean or null
Required: No
Default Value: true
Có lưu trữ phản hồi mô hình đã tạo để truy xuất sau thông qua API hay không.
suối
Type: Boolean or null
Required: No
Default Value: false
Nếu được đặt thành true, dữ liệu phản hồi của mô hình sẽ được truyền trực tuyến tới máy khách bằng cách sử dụng Sự kiện do máy chủ gửi khi dữ liệu được tạo.
nhiệt độ
Type: Number or null
Required: No
Default Value: 1
Nên sử dụng nhiệt độ lấy mẫu nào, trong khoảng từ 0 đến 2. Các giá trị cao hơn như 0,8 sẽ làm cho đầu ra ngẫu nhiên hơn, trong khi các giá trị thấp hơn như 0,2 sẽ làm cho đầu ra tập trung và mang tính quyết định hơn. Chúng tôi thường khuyên bạn nên thay đổi giá trị này hoặc top_p nhưng không nên thay đổi cả hai.
chữ
Type: Object
Required: No
Tùy chọn cấu hình cho phản hồi văn bản của mô hình. Có thể là văn bản thuần túy hoặc dữ liệu JSON có cấu trúc.
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| định dạng | Đối tượng | Không | Chỉ định định dạng mà mô hình phải xuất ra |
Việc định cấu hình { "type": "json_schema" } cho phép kết quả đầu ra có cấu trúc, đảm bảo mô hình sẽ khớp với lược đồ JSON mà bạn cung cấp. Xem hướng dẫn Kết quả đầu ra có cấu trúc để biết thêm thông tin.
Định dạng mặc định là { "type": "text" }, không có lựa chọn nào khác.
Not recommended for gpt-4o and newer models:
Thiết lập { "type": "json_object" } sẽ kích hoạt chế độ JSON cũ hơn, đảm bảo mô hình tạo ra thông báo JSON hợp lệ. Đối với các model được hỗ trợ, json_schema được ưu tiên.
Các loại định dạng văn bản
Văn bản (Văn bản)
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| gõ | Chuỗi | Có | Loại định dạng phản hồi được xác định. Luôn text |
Lược đồ JSON (Lược đồ JSON)
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| tên | Chuỗi | Có | Tên của định dạng phản hồi. Phải chứa a-z, A-Z, 0-9 hoặc bao gồm dấu gạch dưới và dấu gạch ngang, độ dài tối đa 64 |
| lược đồ | Đối tượng | Có | Lược đồ cho định dạng phản hồi, được mô tả dưới dạng đối tượng Lược đồ JSON |
| gõ | Chuỗi | Có | Loại định dạng phản hồi được xác định. Luôn json_schema |
| mô tả | Chuỗi | Không | Mô tả về mục đích của định dạng phản hồi mà mô hình sử dụng để xác định cách phản hồi ở định dạng đó |
| nghiêm ngặt | Boolean hoặc null | Không | Có bật chế độ tuân thủ nghiêm ngặt khi tạo đầu ra hay không. Mặc định là false. Nếu được đặt thành true, mô hình sẽ tuân thủ nghiêm ngặt lược đồ chính xác được xác định trong trường lược đồ. Chỉ một tập hợp con của Lược đồ JSON được hỗ trợ ở chế độ nghiêm ngặt |
Đối tượng JSON (Đối tượng JSON)
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| gõ | Chuỗi | Có | Loại định dạng phản hồi được xác định. Luôn json_object |
Lưu ý: Mô hình sẽ không tạo JSON trừ khi được hệ thống hoặc thông báo của người dùng hướng dẫn làm như vậy. Đối với các model được hỗ trợ, json_schema được khuyến nghị.
tool_choice
Type: String or object
Required: No
Cách mô hình chọn công cụ (hoặc các công cụ) để sử dụng khi tạo phản hồi. Xem tham số tools để biết cách chỉ định các công cụ mà mô hình có thể gọi.
Các loại có thể có
######Chế độ lựa chọn công cụ (Chế độ lựa chọn công cụ)
Type: String
Kiểm soát xem mô hình có gọi công cụ nào hay không.
| Giá trị | Mô tả |
|---|---|
none | Mô hình sẽ không gọi bất kỳ công cụ nào mà thay vào đó tạo ra một thông báo |
auto | Mô hình có thể chọn giữa việc tạo tin nhắn hoặc gọi một hoặc nhiều công cụ |
required | Mô hình phải gọi một hoặc nhiều công cụ |
Công cụ lưu trữ (Hosted tool)
Type: Object
Hướng dẫn mô hình sử dụng công cụ tích hợp để tạo phản hồi.
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| gõ | Chuỗi | Có | Loại công cụ lưu trữ mà mô hình nên sử dụng. Các giá trị được phép là: file_search, web_search_preview, computer_use_preview |
Công cụ chức năng (Function tool)
Type: Object
Sử dụng tùy chọn này để buộc mô hình gọi một hàm cụ thể.
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| tên | Chuỗi | Có | Tên hàm cần gọi |
| gõ | Chuỗi | Có | Đối với các lệnh gọi hàm, loại luôn là function |
công cụ
Type: Array
Required: No
Một loạt các công cụ mà mô hình có thể gọi khi tạo phản hồi. Bạn có thể chỉ định công cụ nào sẽ được sử dụng bằng cách thiết lập tham số tool_choice.
Hai loại công cụ bạn có thể cung cấp cho mô hình là:
- Các công cụ tích hợp: Các công cụ do OpenAI cung cấp để mở rộng khả năng của mô hình, chẳng hạn như tìm kiếm trên web hoặc tìm kiếm tệp.
- Gọi hàm (công cụ tùy chỉnh): Các hàm do bạn xác định, cho phép mô hình gọi mã của riêng bạn.
Công cụ tìm kiếm file (File search)
Type: Object
Một công cụ tìm kiếm nội dung có liên quan trong các tệp được tải lên.
| Tài sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| gõ | Chuỗi | Có | Loại công cụ tìm kiếm tập tin, luôn là file_search |
| vector_store_ids | Mảng | Có | Danh sách ID cửa hàng vector để tìm kiếm |
| bộ lọc | Đối tượng | Không | Bộ lọc áp dụng |
| max_num_results | Số nguyên | Không | Số lượng kết quả tối đa để trả về. Con số này phải nằm trong khoảng từ 1 đến 50 (bao gồm) |
| xếp hạng_options | Đối tượng | Không | Tùy chọn xếp hạng tìm kiếm |
Các loại bộ lọc
Comparison Filter (Comparison Filter)
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| chìa khóa | Chuỗi | Có | Chìa khóa để so sánh với giá trị |
| gõ | Chuỗi | Có | Chỉ định toán tử so sánh: eq, ne, gt, gte, lt, lte- eq: bằng <br />- ne: không bằng<br />-gt: lớn hơn<br />-gte: lớn hơn hoặc bằng<br />-lt: nhỏ hơn<br />-lte: nhỏ hơn hoặc bằng |
| giá trị | Chuỗi/Số/Boolean | Có | Giá trị để so sánh với khóa thuộc tính; hỗ trợ các kiểu chuỗi, số hoặc boolean |
Compound Filter (Compound Filter)
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| bộ lọc | Mảng | Có | Một loạt các bộ lọc để kết hợp. Các mục có thể là bộ lọc so sánh hoặc bộ lọc ghép |
| gõ | Chuỗi | Có | Kiểu hoạt động: and hoặc or |
Tùy chọn xếp hạng
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| người xếp hạng | Chuỗi | Không | Trình xếp hạng được sử dụng để tìm kiếm tệp |
| điểm_ngưỡng | Số | Không | Ngưỡng điểm cho tìm kiếm tệp, một số từ 0 đến 1. Một số gần 1 sẽ cố gắng chỉ trả về những kết quả phù hợp nhất nhưng có thể trả về ít kết quả hơn |
Công cụ chức năng (Function)
Type: Object
Xác định một hàm trong mã của riêng bạn mà mô hình có thể chọn gọi.
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| gõ | Chuỗi | Có | Loại công cụ chức năng, luôn function |
| tên | Chuỗi | Có | Tên hàm cần gọi |
| thông số | Đối tượng | Có | Đối tượng lược đồ JSON mô tả các tham số của hàm |
| nghiêm ngặt | Boolean | Có | Có thực thi xác thực tham số nghiêm ngặt hay không. Mặc định là true |
| mô tả | Chuỗi | Không | Một mô tả của chức năng. Mô hình sử dụng điều này để xác định xem có nên gọi hàm |
Công cụ tìm kiếm trên web (Xem trước tìm kiếm trên web)
Type: Object
Công cụ này tìm kiếm trên web các kết quả có liên quan để sử dụng trong phản hồi.
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| gõ | Chuỗi | Có | Loại công cụ tìm kiếm trên web. Các giá trị có thể có: web_search_preview hoặc web_search_preview_2025_03_11 |
| tìm kiếm_context_size | Chuỗi | Không | Hướng dẫn cấp cao về lượng không gian cửa sổ ngữ cảnh cần sử dụng để tìm kiếm. Các giá trị có thể có: low, medium, high. Mặc định là medium |
| user_location | Đối tượng | Không | Vị trí của người dùng |
| tên miền | Mảng | Không | Danh sách các tên miền để hạn chế tìm kiếm |
Vị trí người dùng
| Bất động sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| gõ | Chuỗi | Có | Loại gần đúng vị trí. Luôn approximate |
| thành phố | Chuỗi | Không | Nhập văn bản miễn phí cho thành phố của người dùng, ví dụ: "San Francisco" |
| đất nước | Chuỗi | Không | Mã quốc gia ISO gồm hai chữ cái của người dùng, ví dụ: "US" |
| vùng | Chuỗi | Không | Nhập văn bản miễn phí cho khu vực của người dùng, ví dụ: "California" |
| múi giờ | Chuỗi | Không | Múi giờ IANA của người dùng, ví dụ: "America/Los_Angeles" |
Công cụ sử dụng máy tính (Xem trước sử dụng máy tính)
Type: Object
Một công cụ để điều khiển máy tính ảo.
| Tài sản | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| gõ | Chuỗi | Có | Loại công cụ sử dụng máy tính. Luôn computer_use_preview |
| hiển thị_height | Số nguyên | Có | Chiều cao của màn hình máy tính |
| display_width | Số nguyên | Có | Chiều rộng của màn hình máy tính |
| môi trường | Chuỗi | Có | Các loại môi trường máy tính cần điều khiển |
top_p
Type: Number or null
Required: No
Default Value: 1
Một giải pháp thay thế cho việc lấy mẫu bằng nhiệt độ, được gọi là lấy mẫu hạt nhân, trong đó mô hình xem xét kết quả của các mã thông báo có khối lượng xác suất top_p. Vì vậy, 0,1 có nghĩa là chỉ các mã thông báo có khối lượng xác suất 10% cao nhất mới được xem xét.
Chúng tôi thường khuyên bạn nên thay đổi giá trị này hoặc temperature nhưng không nên thay đổi cả hai.
cắt ngắn
Type: String or null
Required: No
Default Value: disabled
Chính sách cắt ngắn được sử dụng cho các phản hồi của mô hình:
| Giá trị | Mô tả |
|---|---|
auto | Nếu ngữ cảnh của phản hồi này và phản hồi trước đó vượt quá kích thước cửa sổ ngữ cảnh của mô hình, mô hình sẽ cắt bớt phản hồi bằng cách xóa các mục đầu vào ở giữa cuộc hội thoại để vừa với cửa sổ ngữ cảnh |
disabled | Nếu phản hồi của mô hình vượt quá kích thước cửa sổ ngữ cảnh của mô hình thì yêu cầu sẽ không thành công với lỗi 400 |
người dùng
Type: String
Required: No
Mã định danh duy nhất đại diện cho người dùng cuối, có thể giúp OpenAI giám sát và phát hiện hành vi lạm dụng.
📥 Phản hồi
Trả về một đối tượng phản hồi.
###Phản hồi thành công
Trả về một đối tượng phản hồi hoặc một chuỗi các đối tượng phản hồi phát trực tuyến nếu yêu cầu được truyền phát.
nhận dạng
- Loại: Chuỗi
- Mô tả: Mã định danh duy nhất cho phản hồi
sự vật
- Loại: Chuỗi
- Mô tả: Kiểu đối tượng, giá trị là "response"
đã tạo_at
- Kiểu: Số nguyên
- Mô tả: Dấu thời gian khi phản hồi được tạo
trạng thái
- Loại: Chuỗi
- Mô tả: Trạng thái phản hồi, chẳng hạn như "đã hoàn thành", "in_progress", v.v.
lỗi
- Kiểu: Đối tượng hoặc null
- Mô tả: Chứa thông tin lỗi nếu xảy ra lỗi
####không đầy đủ_chi tiết
- Kiểu: Đối tượng hoặc null
- Description: Chứa thông tin chi tiết nếu phản hồi chưa đầy đủ
hướng dẫn
- Kiểu: Chuỗi hoặc null
- Mô tả: Hướng dẫn hệ thống cung cấp cho mô hình
max_output_tokens
- Kiểu: Số nguyên hoặc null
- Mô tả: Số lượng token đầu ra tối đa
người mẫu
- Loại: Chuỗi
- Mô tả: Tên model sử dụng
đầu ra
- Kiểu: Mảng
- Mô tả: Chứa câu trả lời được tạo và lệnh gọi công cụ
- Nội dung có thể:
- Đối tượng tin nhắn (
type: "tin nhắn") - Đối tượng sử dụng công cụ (
type: "tool_use")
cuộc gọi_tool_song song
- Kiểu: Boolean
- Mô tả: Lệnh gọi công cụ song song có được bật hay không
previous_response_id
- Kiểu: Chuỗi hoặc null
- Mô tả: ID của phản hồi trước đó (dùng cho hội thoại nhiều lượt)
lý luận
- Loại: Đối tượng
- Mô tả: Thông tin liên quan đến lý luận
cửa hàng
- Kiểu: Boolean
- Mô tả: Phản hồi này có được lưu trữ hay không
nhiệt độ
- Loại: Số
- Mô tả: Nhiệt độ lấy mẫu sử dụng
chữ
- Loại: Đối tượng
- Mô tả: Cấu hình định dạng đầu ra văn bản
tool_choice
- Loại: Chuỗi
- Mô tả: Chiến lược lựa chọn công cụ
công cụ
- Kiểu: Mảng
- Mô tả: Danh sách các công cụ có sẵn
top_p
- Loại: Số
- Mô tả: Ngưỡng lấy mẫu hạt nhân
cắt ngắn
- Loại: Chuỗi
- Mô tả: Chính sách cắt ngắn
cách sử dụng
- Loại: Đối tượng
- Mô tả: Thống kê sử dụng Token
- Của cải:
input_tokens: Số lượng token sử dụng cho đầu vàoinput_tokens_details: Nhập chi tiết tokenoutput_tokens: Số lượng token sử dụng cho đầu raoutput_tokens_details: Xuất chi tiết tokentotal_tokens: Tổng số token
người dùng
- Kiểu: Chuỗi hoặc null
- Mô tả: Định danh người dùng
siêu dữ liệu
- Loại: Đối tượng
- Mô tả: Thông tin siêu dữ liệu bổ sung