Request Parameters

Request Body (JSON)

{
  "query": "string (required)",
  "conversation_id": "string (optional)",
}

Parameter Description

Parameter Name	Type	Required	Description
query	string	Yes	User query content, supports natural language questions
conversation_id	string	No	Conversation ID, used for context association

Authentication Method

This API requires API Key authentication. Please add the Authorization field to the request header:

Authorization: Bearer <your-api-key>

⚠️ Important Note

• Please replace <your-api-key> with your actual API key
• API keys can be created and managed through the user management interface
• Please keep your API key secure and do not share it with others

Request Example

curl -X POST "[HOST]/api/v1/agent?action=deepsearch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-api-key>" \
  -d '{
    "query": "Please search for the latest AI technology development trends",
    "conversation_id": "conv_1234567890"
  }'

Response Example

event: response.output_item.added
data: {"type":"response.output_item.added","sequence_number":1,"item":{"id":"ws_1761549872262388000","status":"in_progress","type":"web_search_call"}}

......

event: response.output_item.added
data: {"type":"response.output_item.added","sequence_number":116,"output_index":23,"item":{"id":"ws_1761549872262388000","status":"in_progress","type":"web_search_call"}}

event: response.web_search_call.in_progress
data: {"type":"response.web_search_call.in_progress","sequence_number":117,"output_index":23,"item_id":"ws_1761549872262388000"}

event: response.web_search_call.searching
data: {"type":"response.web_search_call.searching","sequence_number":118,"output_index":23,"item_id":"ws_1761549872262388000"}

event: response.web_search_call.completed
data: {"type":"response.web_search_call.completed","sequence_number":119,"output_index":23,"item_id":"ws_1761549872262388000"}

event: response.output_item.done
data: {"type":"response.output_item.done","sequence_number":120,"output_index":23,"item":{"action":{"type":"search","query":"why is 0.9 considered greater than 0.1 in base 10","results":[{"title":"Which is greater 0.9 or 0.10? - Answers","link":"https://math.answers.com/other-math/Which_is_greater_0.9_or_0.10","snippet":"0.10 would be shown as 0.1 because after the decimal place any trailing 0s are dropped.\n\nWith that in mind 0.9 is bigger.\n\nIn mathematics, the number 3 is equivalent to 3.","position":1},{"title":"Q: In base ten 1=0.999…, but what about in other …","link":"https://www.askamathematician.com/2017/01/q-in-base-ten-10-999-but-what-about-in-other-bases-what-about-in-base-1/","snippet":"But things get tricky when you get to base 1. The largest value in a given base is always less than the base; 9 for base 10, 6 for base 7, 37 for base 38, 1 for base 2. So you’d expect that the largest number in base 1 is 01 .","position":2},{"title":"Repeating Decimal Expansions in Different Bases","link":"https://ejmt.mathandtech.org/Contents/eJMT_v16n3p4.pdf","snippet":", lengths of repeating cycles) as a base is varied and discuss p-adic number expansions as well. \nNomenclature and Preinvestigation \nDecimal expansions are used everywhere, and many people are familiar with representations of inte-gers in bases other than base 10 (e.g., binary or hexadecimal numbers).","position":3},{"title":"1.1.1: Scientific Notation - Writing Large and Small Numbers","link":"https://chem.libretexts.org/Courses/Fresno_City_College/Introductory_Chemistry_Atoms_First_for_FCC/01%3A__Basics_of_Measurement/1.01%3A_Taking_Measurements-_Numbers_and_Units/1.1.01%3A_Scientific_Notation_-_Writing_Large_and_Small_Numbers","snippet":"2024年8月16日·In scientific notation, these numbers are expressed in the form \\ [ N \\times 10^n \\nonumber \\] where N is greater than or equal to 1 and less than 10 (1 ≤ N < 10), and n is a …","position":4},{"title":"Scientific Notation | Mathematics for the Liberal Arts Corequisite","link":"https://courses.lumenlearning.com/mathforliberalartscorequisite/chapter/scientific-notation/","snippet":"Remember working with place value for whole numbers and decimals? Our number system is based on powers of 1010. We use tens, hundreds, thousands, and so on. Our decimal numbers are also based on powers of tens—tenths, hundredths, thousandths, and so on. Consider the numbers 40004000 and 0.0040.004. We know that 40004000 means 4×10004×1000 and 0.004...","position":5}]},"id":"ws_1761549872262388000","status":"completed","type":"web_search_call"}}

......

event: response.content_part.added
data: {"type":"response.content_part.added","sequence_number":121,"output_index":24,"item_id":"msg_1761549872262388000","item":{"content_index":0,"item_id":"msg_1761549872262388000","output_index":24,"part":{"annotations":[],"logprobs":[],"text":"","type":"output_text"},"sequence_number":121,"type":"response.content_part.added"}}

event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":122,"output_index":24,"item_id":"msg_1761549872262388000","item":{"content_index":0,"delta":"###","item_id":"msg_1761549872262388000","logprobs":[],"output_index":24,"sequence_number":122,"type":"response.output_text.delta"}}

event: response.output_text.done
data: {"type":"response.output_text.done","sequence_number":123,"output_index":24,"item_id":"msg_1761549872262388000","item":{"content_index":0,"item_id":"msg_1761549872262388000","output_index":24,"sequence_number":123,"type":"response.output_text.done"}}

......

event: response.content_part.added
data: {"type":"response.content_part.added","sequence_number":883,"output_index":278,"item_id":"msg_1761549872262388000","item":{"content_index":0,"item_id":"msg_1761549872262388000","output_index":278,"part":{"annotations":[],"logprobs":[],"text":"","type":"output_text"},"sequence_number":883,"type":"response.content_part.added"}}

event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":884,"output_index":278,"item_id":"msg_1761549872262388000","item":{"content_index":0,"delta":"1","item_id":"msg_1761549872262388000","logprobs":[],"output_index":278,"sequence_number":884,"type":"response.output_text.delta"}}

event: response.output_text.done
data: {"type":"response.output_text.done","sequence_number":885,"output_index":278,"item_id":"msg_1761549872262388000","item":{"content_index":0,"item_id":"msg_1761549872262388000","output_index":278,"sequence_number":885,"type":"response.output_text.done"}}

event: response.cost.final
data: {"type":"response.cost.final","sequence_number":886,"output_index":279,"item":{"output_index":279,"sequence_number":886,"total_cost":0.05522360760000001,"type":"response.cost.final"}} 

data: [DONE]