# Alibaba Cloud Voice Navigator API

> Alibaba Cloud Voice Navigator API on Apizie: 41 endpoints (Associates a chatbot, Auditions a TTS voice, Starts a session, Collects digits, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-voicenavigator`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/voicenavigator
- Page: https://zieapi.vercel.app/api/cloud/aliyun-voicenavigator
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-voicenavigator/openapi.json

Alibaba Cloud OpenAPI for Voice Navigator (voicenavigator, version 2018-06-12). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Associates a chatbot
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/associate-chatbot-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ChatbotInstanceId | string | no | The ID of the chatbot |
| ChatbotName | string | no | The name of the chatbot |
| UnionSource | string | no | The UnionSource |
| NluServiceParamsJson | string | no | The NluServiceParamsJson |
| NluServiceType | string | no | The NluServiceType |

### Auditions a TTS voice
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/audit-ttsvoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The navigation instance ID |
| Voice | string | yes | The voice |
| Text | string | yes | The audition text |
| SpeechRate | string | yes | The speech rate |
| Volume | string | yes | The volume |
| Engine | string | no | The TTS engine |
| PitchRate | string | no | The PitchRate |
| SecretKey | string | no | The AccessKey secret |
| AccessKey | string | no | The AccessKey ID of the namespace |
| AppKey | string | no | The AppKey of the third-party voice configuration |
| ExtParams | string | no | The extended parameters |
| NlsServiceType | string | no | The NlsServiceType |

### Starts a session
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/begin-dialogue` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| CalledNumber | string | no | The called number |
| CallingNumber | string | yes | The calling number |
| ConversationId | string | yes | The session ID |
| InitialContext | string | no | The session context |
| InstanceId | string | yes | The instance ID |
| InstanceOwnerId | integer | no | The instance owner ID |

### Collects digits
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/collected-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ConversationId | string | yes | The session ID |
| Number | string | no | The phone number |
| InstanceOwnerId | integer | no | The instance owner ID |
| AdditionalContext | string | no | The AdditionalContext |

### Creates a download URL for a file
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/create-download-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| DownloadTaskId | string | yes | The task ID |
| FileId | string | yes | The ID of the file. You can call the https://help.aliyun.com/document_detail/173942.html operation to query the file ID |

### Creates an intelligent navigation instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/create-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| Name | string | yes | The name of the digital employee scenario |
| Description | string | no | The description of the scenario |
| Concurrency | integer | yes | Specifies the maximum number of concurrent requests for the scenario |
| UnionSource | string | no | The source. Valid values: CCC: Cloud Call Center |
| UnionInstanceId | string | no | The instance ID. If UnionSource is set to CCC, set UnionInstanceId to the instance ID of Cloud Call Center |
| NluServiceParamsJson | string | no | The parameter settings for the large model service. Select Function Compute |

### Initiates a session in the debug environment
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/debug-begin-dialogue` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| CalledNumber | string | no | The called number |
| CallingNumber | string | yes | The calling number |
| ConversationId | string | yes | The session ID |
| InitialContext | string | no | The session information |
| InstanceId | string | yes | The instance ID |
| ShouldUseSandBox | string | no | Specifies whether to use sandbox mode |

### Collects digits in the debug environment
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/debug-collected-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ConversationId | string | yes | The session ID |
| Number | string | no | The collected digit input |

### Tests a conversation in the debug environment
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/debug-dialogue` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| ConversationId | string | yes | The user utterance |
| AdditionalContext | string | no | The session context |
| InstanceId | string | yes | The instance ID |
| Utterance | string | yes | The user utterance |

### Deletes a navigation instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/delete-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |

### Queries the conversation information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/describe-conversation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ConversationId | string | yes | The conversation ID |

### Queries the context data of a session
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/describe-conversation-context` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ConversationId | string | yes | The session ID |

### Queries the status of an export task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/describe-export-progress` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ExportTaskId | string | yes | The export task ID |

### Retrieves the details of a navigation instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/describe-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The ID of the instance |

### Queries the IVR configuration of an instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/describe-navigation-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |

### Retrieves the conversation recording
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/describe-recording` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ConversationId | string | yes | The session ID |
| NeedVoiceSliceRecording | string | no | The NeedVoiceSliceRecording |

### Queries the statistics of the current instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/describe-statistical-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| TimeUnit | string | yes | The date unit |
| BeginTimeLeftRange | integer | no | The left boundary of the start time range |
| BeginTimeRightRange | integer | no | The right boundary of the start time range |

### Queries the text-to-speech (TTS) configuration
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/describe-ttsconfig` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The scenario ID |
| InstanceOwnerId | integer | no | The ID of the instance owner |

### Initiates a conversation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/dialogue` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ConversationId | string | yes | The session ID |
| Utterance | string | yes | The user utterance |
| CalledNumber | string | no | The called number |
| CallingNumber | string | no | The calling number |
| AdditionalContext | string | no | The session context |
| InstanceOwnerId | integer | no | The Alibaba Cloud account ID of the instance owner |
| Emotion | string | no | The Emotion |

### Deletes an intelligent navigation instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/disable-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |

### Starts an instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/enable-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |

### Ends an ongoing dialogue
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/end-dialogue` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The ID of the instance |
| ConversationId | string | yes | The ID of the conversation |
| InstanceOwnerId | integer | no | The ID of the instance owner |
| HangUpParams | string | no | The hang-up parameters, in a JSON string |

### Exports session details
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/export-conversation-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| CallingNumber | string | no | The calling number |
| BeginTimeLeftRange | integer | no | The lower bound of the start date range |
| BeginTimeRightRange | integer | no | The upper bound of the start date range |
| Options | string | no | The optional parameters (JSON-encoded) |
| RoundsLeftRange | integer | no | The RoundsLeftRange |
| RoundsRightRange | integer | no | The RoundsRightRange |
| Result | integer | no | The Result |
| DebugConversation | integer | no | The DebugConversation |
| AbTestId | string | no | The ABTest ID |

### Exports statistics
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/export-statistical-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| TimeUnit | string | yes | The time unit |
| ExportType | string | yes | The export type |
| BeginTimeLeftRange | integer | no | The start time |
| BeginTimeRightRange | integer | no | The end time used as a filter condition |

### Retrieves the ASR configuration
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/get-asr-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| EntryId | string | no | The entity ID corresponding to config_level |
| ConfigLevel | integer | no | The policy level. Valid values: 0: system. 1: tenant. 2: instance |

### Retrieves the real-time concurrency of an instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/get-real-time-concurrency` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |

### Queries a list of instances
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/list-chatbot-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| PageNumber | integer | yes | The page number |
| PageSize | integer | no | The number of entries per page |
| UnionSource | string | no | The UnionSource |
| NluServiceType | string | no | The NluServiceType |
| NluServiceParamsJson | string | no | The NluServiceParamsJson |

### Retrieves the conversation details for a specific conversation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/list-conversation-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ConversationId | string | yes | The conversation ID |

### Queries a list of sessions
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/list-conversations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance IDs |
| PageNumber | integer | yes | The page number |
| PageSize | integer | yes | The number of entries per page |
| CallingNumber | string | no | The calling number |
| Result | integer | no | The result |
| Query | string | no | The query conditions |
| BeginTimeLeftRange | integer | no | The lower bound of the start time range |
| BeginTimeRightRange | integer | no | The upper bound of the start time range |
| IsSandBox | string | no | Specifies whether the sandbox mode is enabled |
| RoundsLeftRange | integer | no | The lower bound of the conversation rounds range |
| RoundsRightRange | integer | no | The upper bound of the conversation rounds range |
| DebugConversation | integer | no | The DebugConversation |
| AbTestId | string | no | The AB test ID |

### Queries the list of download tasks
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/list-download-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| PageNumber | integer | yes | The page number |
| PageSize | integer | yes | The number of entries per page |

### Queries a paginated list of intelligent navigation instances for the current tenant
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/list-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| PageNumber | integer | yes | The page number |
| PageSize | integer | yes | The number of entries per page |
| NluServiceTypeListJsonString | string | no | The NLU type and the filter condition for the source of dialog capabilities. If you do not specify this parameter, all types are selected.… |
| UnionSource | string | no | The source. Valid values: CCC: Cloud Call Center |
| UnionInstanceId | string | no | The instance ID. If UnionSource is set to CCC, set UnionInstanceId to the instance ID of Cloud Call Center |
| Name | string | no | The filter condition for the scenario name |
| Status | string | no | The filter condition for the current scenario status. If you do not specify this parameter, all statuses are selected by default. Valid… |
| Number | string | no | The filter condition for the inbound number |
| InstanceIdListJsonString | string | no | The list of digital employee scenario IDs |

### Modifies the ASR configuration
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/modify-asr-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| EntryId | string | no | The entity ID corresponding to config_level |
| ConfigLevel | integer | no | The policy level. Valid values: 0: system. 1: tenant. 2: instance |
| AsrVocabularyId | string | no | The hotword ID. You can view the ASR hotword ID on the ASR Hotword Management page… |
| AsrCustomizationId | string | no | The dataset ID |
| AsrAcousticModelId | string | no | The ASR acoustic model ID |
| AsrClassVocabularyId | string | no | The ASR hotword ID |
| Engine | string | no | The TTS engine |
| EngineXunfei | string | no | The iFLYTEK ASR configuration parameters |
| NlsServiceType | string | no | NluServiceType |
| AppKey | string | no | The AppKey of the engine |
| AsrOverrides | string | no | The AsrOverrides |
| AsrOverridesUuid | string | no | The ASR error correction dictionary ID |

### Modifies the greeting configuration
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/modify-greeting-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| GreetingWords | string | yes | The greeting message |
| SourceType | string | yes | The type |
| IntentTrigger | string | no | The trigger intent |

### Modifies an instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/modify-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | no | The Name |
| Description | string | no | The description |
| Concurrency | integer | yes | The maximum concurrency of the instance |

### Modifies the silence timeout configuration for a voice bot instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/modify-silence-timeout-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Prompt | string | yes | The prompt that plays when the system detects no user input during the specified timeout period |
| Timeout | integer | yes | The duration of the silence timeout, in seconds |
| Threshold | integer | yes | The maximum number of times the system plays the silence timeout prompt before it performs the post-prompt action |
| FinalPrompt | string | yes | The prompt that plays after the silence timeout threshold is reached |
| FinalAction | string | yes | Action After Prompt |
| FinalActionParams | string | no | Parameters for the post-prompt action, specified in a JSON string |
| SourceType | string | yes | The type of source that triggers the action |
| IntentTrigger | string | no | The intent trigger for the silence timeout |

### Modifies the TTS configuration
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/modify-ttsconfig` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The scenario ID |
| Voice | string | no | The voice |
| SpeechRate | string | no | The speech rate |
| Volume | string | no | The volume |
| PitchRate | string | no | The pitch rate |
| NlsServiceType | string | no | The TTS service invoke type |
| AppKey | string | no | The AppKey of the third-party voice configuration |
| Engine | string | no | The TTS engine |
| EngineXunfei | string | no | The iFLYTEK engine parameters |
| AliCustomizedVoice | string | no | The personalized custom voice ID |
| TtsOverrides | string | no | The TTS error correction dictionary |
| TtsOverridesUuid | string | no | The TTS error correction dictionary ID |
| ExtParams | string | no | The ExtParams |
| BackgroundMusicName | string | no | The BackgroundMusicName |

### Modifies the rejection configuration
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/modify-unrecognizing-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Prompt | string | yes | The rejection prompt |
| Threshold | integer | yes | The maximum number of rejections |
| FinalPrompt | string | yes | The final rejection prompt |
| FinalAction | string | yes | The rejection action |
| FinalActionParams | string | no | The action parameters |

### Retrieves a list of conversation records
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/query-conversations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The ID of the instance |
| CallingNumber | string | no | The calling number |
| BeginTimeLeftRange | integer | no | The start of the time range to query. This value is a Unix timestamp in milliseconds |
| BeginTimeRightRange | integer | no | The end of the time range to query. This value is a Unix timestamp in milliseconds |
| PageNumber | integer | yes | The page number |
| PageSize | integer | yes | The number of entries per page |

### Saves a recording
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/save-recording` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ConversationId | string | yes | The session ID |
| StartTime | integer | yes | The start time of the recording |
| Duration | string | yes | The duration of the recording |
| FileName | string | yes | The file name |
| FilePath | string | yes | The file path |
| Type | string | yes | The type of the recording file |
| InstanceOwnerId | integer | no | The ID of the account to which the instance belongs |
| VoiceSliceRecordingList | string | no | The VoiceSliceRecordingList |

### Triggers a silence timeout
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/silence-timeout` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ConversationId | string | yes | The session ID |
| InitialContext | string | no | The session information context |
| InstanceOwnerId | integer | no | The ID of the instance owner |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://voicenavigator.cn-hangzhou.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/associate-chatbot-instance" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Voice Navigator API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-voicenavigator/associate-chatbot-instance with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Voice Navigator API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Voice Navigator itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Voice Navigator API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-voicenavigator.

### What is the status of the Alibaba Cloud Voice Navigator API?
Needs your own provider key (bring your own key)