88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
Chat

Đị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/responses

Tạ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_KEY

Trong đó $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ạiMô tả
ChuỗiNhậ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àoDanh 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ảnLoạiBắt buộcMô tả
nội dungChuỗi hoặc mảngĐầ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ỗiVai trò của thông điệp đầu vào Các giá trị có thể có: user, assistant, system, hoặc developer
ChuỗiKhôngLoạ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ảnLoạiBắt buộcMô tả
văn bảnChuỗiKiểu nhập văn bản được cung cấp cho mô hình
ChuỗiLoại mục đầu vào, luôn là input_text
Nhập hình ảnh
Bất động sảnLoạiBắt buộcMô tả
chi tiếtChuỗiMứ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
ChuỗiLoại mục đầu vào, luôn là input_image
tập tin_idChuỗiKhôngID tệp sẽ được gửi đến mô hình
hình ảnh_urlChuỗiKhôngURL 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ảnLoạiBắt buộcMô tả
ChuỗiLoại mục đầu vào, luôn là input_file
file_dataChuỗiKhôngNội dung file cần gửi tới mô hình
tập tin_idChuỗiKhôngID tệp sẽ được gửi đến mô hình
tên tập tinChuỗiKhôngTê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ảnLoạiBắt buộcMô tả
văn bảnChuỗiĐầu ra văn bản được tạo bởi mô hình
ChuỗiLoại mục đầu ra, luôn là output_text
chú thíchMảngChú 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ảnLoạiBắt buộcMô tả
tập tin_idChuỗiID của tập tin
chỉ mụcSố nguyênChỉ mục của file trong danh sách file
ChuỗiLoại trích dẫn của tập tin, luôn là file_citation

Trích dẫn URL:

Bất động sảnLoạiBắt buộcMô tả
end_indexSố nguyênChỉ mục ký tự cuối cùng của trích dẫn URL trong tin nhắn
chỉ mục bắt đầuSố nguyênChỉ mục của ký tự đầu tiên của trích dẫn URL trong tin nhắn
tiêu đềChuỗiTiêu đề của tài nguyên web
ChuỗiLoại trích dẫn URL, luôn url_citation
urlChuỗiURL của tài nguyên web

Đường dẫn tệp:

Bất động sảnLoạiBắt buộcMô tả
tập tin_idChuỗiID của tập tin
chỉ mụcSố nguyênChỉ mục của file trong danh sách file
ChuỗiKiể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ảnLoạiBắt buộcMô tả
từ chốiChuỗiLời giải thích từ chối của người mẫu
ChuỗiKiể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ảnLoạiBắt buộcMô tả
idChuỗiID duy nhất cho lệnh gọi công cụ tìm kiếm tệp
truy vấnMảngTruy vấn được sử dụng để tìm kiếm tệp
trạng tháiChuỗiTrạ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
ChuỗiKiể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 nullKhôngKế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ảnLoạiBắt buộcMô tả
idChuỗiID duy nhất cho lệnh gọi công cụ tìm kiếm trên web
trạng tháiChuỗiTrạng thái của lệnh gọi công cụ tìm kiếm trên web
ChuỗiKiể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ảnLoạiBắt buộcMô tả
lập luậnChuỗiChuỗi đối số JSON được truyền cho hàm
gọi_idChuỗiID duy nhất của lệnh gọi công cụ chức năng do mô hình tạo ra
tênChuỗiTên hàm cần chạy
ChuỗiKiểu của lệnh gọi công cụ chức năng, luôn là function_call
idChuỗiKhôngID duy nhất cho lệnh gọi công cụ chức năng
trạng tháiChuỗiKhôngTrạ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ảnLoạiBắt buộcMô tả
hành độngĐối tượngHà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_idChuỗiMã định danh được sử dụng khi phản hồi đầu ra lệnh gọi công cụ
idChuỗiID duy nhất cho cuộc gọi máy tính
đang chờ xử lý_safety_checksMảngĐang chờ kiểm tra an toàn cho cuộc gọi máy tính
trạng tháiChuỗiTrạng thái của mặt hàng. Các giá trị có thể có: in_progress, completed, hoặc incomplete
ChuỗiKiể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 độngMô tả
bấm vàoThao tác click chuột
double_clickThao tác click đúp chuột
kéoThao tác kéo
nhấn phímThao tác nhấn phím
di chuyểnThao tác di chuyển chuột
ảnh chụp màn hìnhThao tác chụp ảnh màn hình
cuộnThao tác cuộn
Thao tác nhập văn bản
chờ đợiChờ hoạt động
Đầu ra cuộc gọi của công cụ máy tính
Bất động sảnLoạiBắt buộcMô tả
gọi_idChuỗiID của lệnh gọi công cụ máy tính đã tạo ra kết quả
đầu raĐối tượngẢnh chụp màn hình máy tính dùng cho công cụ sử dụng máy tính
ChuỗiLoạ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_checksMảngKhôngKiểm tra an toàn do API báo cáo đã được nhà phát triển xác nhận
idChuỗiKhôngID của đầu ra cuộc gọi công cụ máy tính
trạng tháiChuỗiKhôngTrạ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ảnLoạiBắt buộcMô tả
gọi_idChuỗiID duy nhất của lệnh gọi công cụ chức năng do mô hình tạo ra
đầu raChuỗiChuỗi JSON của đầu ra lệnh gọi công cụ hàm
ChuỗiLoại đầu ra lệnh gọi công cụ chức năng, luôn là function_call_output
idChuỗiKhôngID duy nhất cho đầu ra lệnh gọi công cụ chức năng
trạng tháiChuỗiKhôngTrạ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ảnLoạiBắt buộcMô tả
idChuỗiMã định danh duy nhất cho nội dung lý luận
tóm tắtMảngNội dung văn bản lý luận
ChuỗiLoại đối tượng, luôn luôn là reasoning
nội dung được mã hóaChuỗi hoặc nullKhôngNộ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áiChuỗiKhôngTrạ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ảnLoạiBắt buộcMô tả
văn bảnChuỗiBả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
ChuỗiLoại đối tượng, luôn luôn là summary_text
Tham khảo mặt hàng
Bất động sảnLoạiBắt buộcMô tả
idChuỗiID của mục được tham chiếu
ChuỗiKhôngLoạ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.resultsBao 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_urlBao gồm URL hình ảnh trong thông báo đầu vào
computer_call_output.output.image_urlBao gồm URL hình ảnh trong đầu ra cuộc gọi máy tính
reasoning.encrypted_contentBao 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ảnLoạiBắt buộcMô tả
nỗ lựcChuỗi hoặc nullKhôngMứ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ắtChuỗi hoặc nullKhôngTó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ắtChuỗi hoặc nullKhôngKhô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ả
autoNế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ễ
defaultYê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ễ
flexYê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ảnLoạiBắt buộcMô tả
định dạngĐối tượngKhôngChỉ đị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ảnLoạiBắt buộcMô tả
ChuỗiLoạ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ảnLoạiBắt buộcMô tả
tênChuỗiTê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ượngLược đồ cho định dạng phản hồi, được mô tả dưới dạng đối tượng Lược đồ JSON
ChuỗiLoại định dạng phản hồi được xác định. Luôn json_schema
mô tảChuỗiKhôngMô 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ặtBoolean hoặc nullKhôngCó 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ảnLoạiBắt buộcMô tả
ChuỗiLoạ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ả
noneMô 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
autoMô 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ụ
requiredMô 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ảnLoạiBắt buộcMô tả
ChuỗiLoạ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ảnLoạiBắt buộcMô tả
tênChuỗiTên hàm cần gọi
ChuỗiĐố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.

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ảnLoạiBắt buộcMô tả
ChuỗiLoại công cụ tìm kiếm tập tin, luôn là file_search
vector_store_idsMảngDanh sách ID cửa hàng vector để tìm kiếm
bộ lọcĐối tượngKhôngBộ lọc áp dụng
max_num_resultsSố nguyênKhôngSố 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ượngKhôngTù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ảnLoạiBắt buộcMô tả
chìa khóaChuỗiChìa khóa để so sánh với giá trị
ChuỗiChỉ đị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ố/BooleanGiá 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ảnLoạiBắt buộcMô tả
bộ lọcMảngMộ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
ChuỗiKiểu hoạt động: and hoặc or
Tùy chọn xếp hạng
Bất động sảnLoạiBắt buộcMô tả
người xếp hạngChuỗiKhôngTrình xếp hạng được sử dụng để tìm kiếm tệp
điểm_ngưỡngSốKhôngNgưỡ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ảnLoạiBắt buộcMô tả
ChuỗiLoại công cụ chức năng, luôn function
tênChuỗiTên hàm cần gọi
thông sốĐối tượngĐối tượng lược đồ JSON mô tả các tham số của hàm
nghiêm ngặtBooleanCó thực thi xác thực tham số nghiêm ngặt hay không. Mặc định là true
mô tảChuỗiKhôngMộ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ảnLoạiBắt buộcMô tả
ChuỗiLoạ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_sizeChuỗiKhôngHướ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ượngKhôngVị trí của người dùng
tên miềnMảngKhôngDanh 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ảnLoạiBắt buộcMô tả
ChuỗiLoại gần đúng vị trí. Luôn approximate
thành phốChuỗiKhôngNhập văn bản miễn phí cho thành phố của người dùng, ví dụ: "San Francisco"
đất nướcChuỗiKhôngMã quốc gia ISO gồm hai chữ cái của người dùng, ví dụ: "US"
vùngChuỗiKhôngNhậ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ỗiKhôngMú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ảnLoạiBắt buộcMô tả
ChuỗiLoại công cụ sử dụng máy tính. Luôn computer_use_preview
hiển thị_heightSố nguyênChiều cao của màn hình máy tính
display_widthSố nguyênChiều rộng của màn hình máy tính
môi trườngChuỗiCá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ả
autoNế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
disabledNế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ào
  • input_tokens_details: Nhập chi tiết token
  • output_tokens: Số lượng token sử dụng cho đầu ra
  • output_tokens_details: Xuất chi tiết token
  • total_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

Mục lục

📝 Giới thiệu
💡 Yêu cầu Ví dụ
Trả lời văn bản cơ bản ✅
Phản hồi phân tích hình ảnh ✅
Công cụ tìm kiếm trên web ✅
Công cụ tìm kiếm tệp ✅
Phản hồi trực tuyến ✅
Gọi hàm ✅
Khả năng suy luận ✅
📮 Yêu cầu
Điểm cuối
Phương thức xác thực
Thông số nội dung yêu cầu
đầu vào
Các loại có thể có
Đối tượng thông báo đầu vào
Loại mục nội dung
Nhập văn bản
Nhập hình ảnh
Nhập tập tin
Loại mục đầu ra
Văn bản đầu ra
Các loại chú thích
Phản hồi từ chối
Các loại lệnh gọi công cụ
Cuộc gọi công cụ tìm kiếm tệp
Gọi công cụ tìm kiếm trên web
Gọi công cụ chức năng
Gọi công cụ máy tính
Đầu ra cuộc gọi của công cụ máy tính
Đầu ra cuộc gọi của công cụ chức năng
Lý luận Các mục liên quan
Tham khảo mặt hàng
người mẫu
bao gồm
hướng dẫn
max_output_tokens
siêu dữ liệu
cuộc gọi_tool_song song
previous_response_id
lý luận
cấp_dịch vụ
cửa hàng
suối
nhiệt độ
chữ
Các loại định dạng văn bản
Văn bản (Văn bản)
Lược đồ JSON (Lược đồ JSON)
Đối tượng JSON (Đối tượng JSON)
tool_choice
Các loại có thể có
Công cụ lưu trữ (Hosted tool)
Công cụ chức năng (Function tool)
công cụ
Công cụ tìm kiếm file (File search)
Các loại bộ lọc
Tùy chọn xếp hạng
Công cụ chức năng (Function)
Công cụ tìm kiếm trên web (Xem trước tìm kiếm trên web)
Vị trí người dùng
Công cụ sử dụng máy tính (Xem trước sử dụng máy tính)
top_p
cắt ngắn
người dùng
📥 Phản hồi
nhận dạng
sự vật
đã tạo_at
trạng thái
lỗi
hướng dẫn
max_output_tokens
người mẫu
đầu ra
cuộc gọi_tool_song song
previous_response_id
lý luận
cửa hàng
nhiệt độ
chữ
tool_choice
công cụ
top_p
cắt ngắn
cách sử dụng
người dùng
siêu dữ liệu