:::tip \*说明 **Viking AI Search** is an enterprise\-level AI search product powered by generative AI. It leverages the multimodal semantic representation and understanding of large models and combines it with ByteDance's years of best practices in information retrieval. Viking AI Search offers an out\-of\-the\-box platform that helps customers easily build and integrate end\-to\-end, multimodal search and recommendation capabilities for images and text. * To explore more of Viking AI Search's capabilities, visit: [Viking AI Search Engine, the integrated intelligent engine for enterprise search, recommendation, and Q&A](https://www.volcengine.com/product/AI-Search-Rec). ::: --- Returns suggested query terms based on partial search input. ## Request description * Request method: POST * Request URL: * North China: https://aisearch.cn\-beijing.volces.com/api/v1/application/`{application_id}`/search/`{scene_id}`/**query_completion** * Johor: https://aisearch.ap\-southeast\-1.volces.com/api/v1/application/`{application_id}`/search/`{scene_id}`/**query_completion** `{application_id}`: The unique identifier for an application. This ID is assigned by the system after the application is created in the console and can be viewed there. `{scene_id}`: The ID of the search policy. The system assigns a unique ID after a new search policy is created on the experience configuration page. You can copy the policy ID in the console under "Search Experience" by hovering over the policy name. ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/b2f93132684345c2a5f62ecf7be78c3b =2896x) ## Authentication method Use an API Key or Access Key for authentication. For details, see [API Authentication](https://www.volcengine.com/docs/85296/1544950). ## Request Parameters ### Request Body |**Parameter** |**Type** |**Required** |**Example** |**Description** | |---|---|---|---|---| |query |String |Yes |"At the seaside" |The query term for which to generate suggestions. The length of the query term must be greater than or equal to the minimum character count for suggestions configured in the application. | ## Response Parameters ### Request and Response |**Parameter** |**Type** |**Example Value** |**Description** | |---|---|---|---| |request_id |String |25ee998a\-5462\-9385\-9f18\-035f1da7a6e5 |A unique request identifier used to quickly locate the execution of a request. | |result |Result |See below: Result |Search suggestion results | ### Data Structure #### Result |**Parameter** |**Type** |**Example value** |**Description** | |---|---|---|---| |suggestions |Array of[Suggestion](/docs/85296/1544961#b804b340) |See Suggestion below. |A list of search suggestions. 10 items are returned by default. To adjust this, modify the maximum number of recalled suggestions in the application configuration. | #### Suggestion |**Parameter** |**Type** |**Example value** |**Description** | |---|---|---|---| |suggestion |String |"Camping by the sea" |Single search suggestion | ## Request Example ```Plain Text curl -X POST 'https://aisearch.cn-beijing.volces.com/api/v1/application/60590835675/search/g0BAC4BM/query_completion' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "query": "在海边" }' ``` ## Response Example ```Plain Text { "request_id": "25ee998a-5462-9385-9f18-035f1da7a6e5", "result": { "suggestions": [ { "suggestion": "在海边散步" }, { "suggestion": "在海边露营" }, { "suggestion": "在海边度假" }, { "suggestion": "在海边冲浪" }, { "suggestion": "在海边看日出" } ] } } ``` ## Error Handling ### Error Code For the error codes for this API, refer to the [Common Error Codes](/docs/85296/1544941)documentation. :::tip \*说明 To experience more Viking AI search capabilities, go to: [Viking AI Search Engine: The All-in-One Intelligent Engine for Enterprise Search, Recommendations, and Q&A](https://www.volcengine.com/product/AI-Search-Rec) :::