path: root/data/en_us/tingwu/2022-09-30/api-docs.php

<?php return [
    'version' => '1.0',
    'info' => ['style' => 'ROA', 'product' => 'tingwu', 'version' => '2022-09-30'],
    'directories' => [
        [
            'children' => ['CreateMeetingTrans', 'GetMeetingTrans', 'StopMeetingTrans'],
            'type' => 'directory',
            'title' => 'Real-time meeting transcription',
        ],
        [
            'children' => ['CreateFileTrans', 'GetFileTrans'],
            'type' => 'directory',
            'title' => 'Meeting audio and video file transcription',
        ],
    ],
    'components' => [
        'schemas' => [],
    ],
    'apis' => [
        'CreateFileTrans' => [
            'summary' => 'Create an audio or video transcription task.',
            'path' => '/openapi/file-trans',
            'methods' => ['put'],
            'schemes' => ['http', 'https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'consumes' => ['application/json'],
            'produces' => ['application/json'],
            'operationType' => 'write',
            'deprecated' => false,
            'systemTags' => [],
            'parameters' => [
                [
                    'name' => 'body',
                    'in' => 'body',
                    'style' => 'json',
                    'schema' => [
                        'title' => '',
                        'description' => 'Request body.',
                        'type' => 'object',
                        'properties' => [
                            'AppKey' => ['description' => 'AppKey of the project created in the console.', 'type' => 'string', 'required' => true, 'example' => 'JV1sRTisRMi****', 'title' => ''],
                            'TransKey' => ['description' => 'Custom task identifier. This value is returned unchanged in task queries or task completion callbacks.', 'type' => 'string', 'example' => 'trans_123', 'title' => '', 'required' => false],
                            'AudioOssBucket' => ['description' => 'OSS bucket where the audio file to be transcribed is stored.', 'type' => 'string', 'required' => false, 'example' => 'bucket', 'title' => ''],
                            'AudioOssPath' => ['description' => 'OSS file path of the audio to be transcribed, or a custom downloadable URL (http|https). If AudioOssBucket is not empty, provide the OSS file path (...../*.mp3). If AudioOssBucket is empty, provide a custom downloadable URL (http\\://……/*.mp3).', 'type' => 'string', 'required' => true, 'example' => 'dir1/dir2/filename'."\n"
                                .'http://……/*.mp3', 'title' => ''],
                            'AudioLanguage' => [
                                'description' => 'Language model used for audio transcription.'."\n"
                                    .'cn: Chinese.'."\n"
                                    .'en: English.'."\n"
                                    .'yue: Cantonese.'."\n"
                                    .'fspk: Mixed Chinese and English.',
                                'type' => 'string',
                                'required' => true,
                                'example' => 'cn',
                                'enum' => [],
                                'title' => '',
                            ],
                            'AudioRoleNum' => ['description' => 'Enable speaker diarization. Note: Only effective for audio with a sample rate of 16 kHz or higher.'."\n"
                                .'Not set: Speaker diarization is disabled.'."\n"
                                .'0: Speaker diarization with an unspecified number of speakers.'."\n"
                                .'2: Speaker diarization for exactly 2 speakers.', 'type' => 'string', 'example' => '2', 'title' => '', 'required' => false],
                            'AudioOutputEnabled' => ['description' => 'Enable MP3 audio transcoding. Default is false.', 'type' => 'boolean', 'default' => 'false', 'title' => '', 'required' => false, 'example' => 'false'],
                            'AudioOutputOssBucket' => ['description' => 'OSS bucket where transcoded audio is stored when audio transcoding is enabled. Must match the OSS bucket configured for the project in the console.', 'type' => 'string', 'example' => 'bucket', 'title' => '', 'required' => false],
                            'AudioOutputOssPath' => ['description' => 'OSS file path where transcoded audio is stored when audio transcoding is enabled. The path must start with "tingwu/".', 'type' => 'string', 'example' => 'tingwu/dir/filename', 'title' => '', 'required' => false],
                            'VideoOutputEnabled' => ['title' => 'Indicates whether MP4 format video conversion is enabled to transform non-MP4 videos into MP4 format. Default value: false.', 'description' => 'Enable video transcoding. Default is false.', 'type' => 'boolean', 'default' => 'false', 'required' => false, 'example' => 'false'],
                            'VideoOutputOssBucket' => ['title' => 'The OSS Bucket to which the converted video is written when MP4 video conversion is enabled.', 'description' => 'OSS bucket where transcoded video is stored when video transcoding is enabled. Must match the OSS bucket configured for the project in the console.', 'type' => 'string', 'example' => 'bucket', 'required' => false],
                            'VideoOutputOssPath' => ['title' => 'When MP4 video transcoding is enabled, this specifies the OSS path to which the transcoded video is written.  ', 'description' => 'OSS file path where transcoded video is stored when video transcoding is enabled. The path must start with "tingwu/".', 'type' => 'string', 'example' => 'tingwu/dir/filename'."\n", 'required' => false],
                            'TransResultOssBucket' => ['description' => 'OSS bucket where transcription and intelligent extraction results are stored. Must match the OSS bucket configured for the project in the console.', 'type' => 'string', 'required' => true, 'example' => 'bucket', 'title' => ''],
                            'TransResultOssPath' => ['description' => 'OSS file path where transcription and intelligent extraction results are stored. The path must start with "tingwu/".', 'type' => 'string', 'required' => true, 'example' => 'tingwu/dir/filename', 'title' => ''],
                            'AudioSegmentsEnabled' => ['description' => 'Enable writing detected valid audio segments to output. Default is false.', 'type' => 'boolean', 'default' => 'false', 'title' => '', 'required' => false, 'example' => 'false'],
                            'Tags' => ['description' => 'System extension: tags', 'type' => 'object', 'required' => false, 'title' => '', 'example' => ''],
                            'AsrParams' => ['description' => 'Additional ASR transcription parameters, such as hotword vocabulary\\_id.', 'type' => 'object', 'required' => false, 'example' => '{'."\n"
                                .'  "vocabulary_id": "e2a9a9be3128417fb4d181ebfbe8****"'."\n"
                                .'}', 'title' => ''],
                            'LabParams' => ['description' => 'System extension: experimental transcription parameters', 'type' => 'object', 'required' => false, 'title' => '', 'example' => ''],
                            'AbilityParams' => ['description' => 'Capability extension', 'type' => 'object', 'required' => false, 'title' => '', 'example' => ''],
                        ],
                        'required' => false,
                        'example' => '',
                    ],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => 'Schema of Response',
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['description' => 'Request ID, for debugging only.', 'type' => 'string', 'example' => '35124E1C-AE99-5D6C-A52E-BD689D8D****', 'title' => ''],
                            'Code' => ['description' => 'Status code.', 'type' => 'string', 'example' => '0', 'title' => ''],
                            'Message' => ['description' => 'Status message.', 'type' => 'string', 'example' => 'Success.', 'title' => ''],
                            'Data' => [
                                'title' => '',
                                'description' => 'Response object.',
                                'type' => 'object',
                                'properties' => [
                                    'TransId' => ['description' => 'Task ID.', 'type' => 'string', 'example' => 'f7de74778d94422283534102dfc0****', 'title' => ''],
                                    'TransKey' => ['description' => 'Task identifier set by the user when creating the task.', 'type' => 'string', 'example' => 'trans_123', 'title' => ''],
                                ],
                                'example' => '',
                            ],
                        ],
                        'example' => '',
                    ],
                ],
            ],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"35124E1C-AE99-5D6C-A52E-BD689D8D****\\",\\n  \\"Code\\": \\"0\\",\\n  \\"Message\\": \\"Success.\\",\\n  \\"Data\\": {\\n    \\"TransId\\": \\"f7de74778d94422283534102dfc0****\\",\\n    \\"TransKey\\": \\"trans_123\\"\\n  }\\n}","type":"json"}]',
            'title' => 'Create a file transcription job  ',
            'changeSet' => [
                ['createdAt' => '2023-08-03T14:00:40.000Z', 'description' => 'Request parameters changed'],
                ['createdAt' => '2023-05-16T15:41:27.000Z', 'description' => 'Request parameters changed'],
                ['createdAt' => '2023-04-21T03:07:45.000Z', 'description' => 'Request parameters changed'],
                ['createdAt' => '2022-12-16T02:17:53.000Z', 'description' => 'Request parameters changed'],
                ['createdAt' => '2022-11-07T03:01:39.000Z', 'description' => 'Request parameters changed'],
                ['createdAt' => '2022-10-20T11:18:30.000Z', 'description' => 'Request parameters changed, Response parameters changed'],
                ['createdAt' => '2022-10-08T22:47:31.000Z', 'description' => 'Request parameters changed'],
                ['createdAt' => '2022-09-22T07:26:27.000Z', 'description' => 'Request parameters changed'],
                ['createdAt' => '2022-09-21T02:44:37.000Z', 'description' => 'OpenAPI offline'],
            ],
            'ramActions' => [
                [
                    'operationType' => '',
                    'ramAction' => [
                        'action' => 'tingwu:CreateFileTrans',
                        'authLevel' => 'operate',
                        'actionConditions' => [],
                        'resources' => [
                            ['validationType' => 'always', 'product' => 'NlsTingwu', 'resourceType' => 'All Resource', 'arn' => '*'],
                        ],
                    ],
                ],
            ],
        ],
        'CreateMeetingTrans' => [
            'summary' => 'Create a real-time meeting.  ',
            'path' => '/openapi/meeting-trans',
            'methods' => ['put'],
            'schemes' => ['http', 'https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'consumes' => ['application/json'],
            'produces' => ['application/json'],
            'operationType' => 'write',
            'deprecated' => false,
            'systemTags' => [],
            'parameters' => [
                [
                    'name' => 'body',
                    'in' => 'body',
                    'style' => 'json',
                    'schema' => [
                        'title' => '',
                        'description' => 'Request body.  ',
                        'type' => 'object',
                        'properties' => [
                            'AppKey' => ['title' => '', 'description' => 'The AppKey of the project created in the console.', 'type' => 'string', 'required' => true, 'example' => 'JV1sRTisRMi****'],
                            'MeetingKey' => ['title' => '', 'description' => 'The meeting identity set by the User, which will be returned unchanged in queries during the meeting or in the End callback after the meeting.', 'type' => 'string', 'required' => false, 'example' => 'meeting_123'],
                            'AudioFormat' => [
                                'title' => '',
                                'description' => 'Audio encoding format: PCM (uncompressed PCM or WAV file) or OPUS (compressed OPUS file).  ',
                                'type' => 'string',
                                'required' => true,
                                'example' => 'pcm',
                                'enum' => [],
                            ],
                            'AudioPackage' => ['title' => '', 'description' => 'Audio packaging method. Set to "multi" when encapsulating multiple audio streams using the Protobuf format based on the Tingwu convention.', 'type' => 'string', 'required' => false, 'example' => 'multi'],
                            'AudioSampleRate' => [
                                'title' => '',
                                'description' => 'Audio sampling rate. Currently supported values are 16000 and 8000 (8000 supports only single-channel Chinese audio).  ',
                                'type' => 'integer',
                                'format' => 'int32',
                                'required' => true,
                                'example' => '16000',
                                'enum' => [],
                            ],
                            'AudioBitRate' => [
                                'title' => '',
                                'description' => 'Audio bit depth for meeting uploads. Currently supported value is 16.  ',
                                'type' => 'integer',
                                'format' => 'int32',
                                'required' => true,
                                'example' => '16',
                                'enum' => [],
                            ],
                            'AudioLanguage' => [
                                'title' => '',
                                'description' => 'The language model used for Audio transcription.  '."\n"
                                    .'cn: Chinese.  '."\n"
                                    .'en: English.  '."\n"
                                    .'yue: Cantonese.  '."\n"
                                    .'fspk: Free switching between Chinese and English.',
                                'type' => 'string',
                                'required' => true,
                                'example' => 'cn',
                                'enum' => [],
                            ],
                            'RealtimeResultEnabled' => ['title' => '', 'description' => 'Specifies whether to enable real-time result return during the meeting. The default value is true.', 'type' => 'boolean', 'required' => false, 'example' => 'true', 'default' => 'false'],
                            'RealtimeResultLevel' => [
                                'title' => '',
                                'description' => 'When real-time result return during a meeting is enabled, this parameter sets the level of recognition result returned. The default value is 1.  '."\n"
                                    .'0: Do not return recognition results.  '."\n"
                                    .'1: Return recognition results when complete sentences are detected.  '."\n"
                                    .'2: Return recognition results for both intermediate and complete sentences.',
                                'type' => 'integer',
                                'format' => 'int32',
                                'required' => false,
                                'example' => '2',
                                'default' => '1',
                                'enum' => [],
                            ],
                            'RealtimeActiveResultLevel' => [
                                'title' => '',
                                'description' => 'When real-time result return during the meeting is enabled and the audio packaging method is set to multi, this parameter specifies the level of speaker identification result return. The default value is 1.  '."\n"
                                    .'0: Do not return Classification Result.  '."\n"
                                    .'1: Return Classification Result when a complete sentence is detected.  '."\n"
                                    .'2: Return Classification Result for both intermediate results and complete sentences.',
                                'type' => 'integer',
                                'format' => 'int32',
                                'required' => false,
                                'example' => '2',
                                'default' => '1',
                                'enum' => [],
                            ],
                            'AudioOutputEnabled' => ['title' => '', 'description' => 'Specifies whether to enable real-time transcoding to MP3 format. Default is false.  ', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'default' => 'false'],
                            'AudioOutputOssBucket' => ['title' => '', 'description' => 'When audio synchronization and transcoding are enabled, the OSS Bucket to which the transcoded audio is written. This must match the OSS Bucket configured in the project settings in the console.  ', 'type' => 'string', 'required' => false, 'example' => 'bucket'],
                            'AudioOutputOssPath' => ['title' => '', 'description' => 'When audio synchronization transcoding is enabled, this parameter specifies the OSS file path to which the transcoded audio is written. The path must have the prefix "tingwu/".', 'type' => 'string', 'required' => false, 'example' => 'tingwu/dir/filename'],
                            'MeetingResultEnabled' => ['title' => '', 'description' => 'Whether to enable Intelligent post-meeting extraction. The default value is false.', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'default' => 'false'],
                            'MeetingResultOssBucket' => ['title' => '', 'description' => 'The OSS Bucket to which the extraction results are written when Intelligent post-meeting extraction is enabled. It must match the OSS Bucket configured for the project in the console.', 'type' => 'string', 'required' => false, 'example' => 'bucket'],
                            'MeetingResultOssPath' => ['title' => '', 'description' => 'The OSS File Path to which the extraction results are written when Intelligent post-meeting extraction is enabled. It must have the prefix "tingwu/".', 'type' => 'string', 'required' => false, 'example' => 'tingwu/dir/filename'],
                            'DocResultEnabled' => ['title' => '', 'description' => 'When Intelligent Post-meeting Extraction is enabled, specifies whether in-meeting recognition results are written. Default is false.  ', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'default' => 'false'],
                            'AudioSegmentsEnabled' => ['title' => '', 'description' => 'When post-meeting intelligent fetch is enabled, this parameter specifies whether to enable writing detection results of valid audio segments. The default value is false.', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'default' => 'false'],
                            'TranslateResultEnabled' => ['title' => '是否开启会中翻译，默认是false。', 'description' => 'Specifies whether to enable in-meeting translation. Default is false.  ', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'default' => 'false'],
                            'TranslateLanguages' => ['title' => '翻译目标语言集合，多个语言间用英文逗号","分隔，当前支持cn、en。', 'description' => 'Collection of target languages for translation. Separate multiple languages with a comma (","). Currently supported languages are cn and en.  ', 'type' => 'string', 'required' => false, 'example' => 'cn,en'],
                            'TranslateResultLevel' => ['title' => '单通道识别或多通道mix流识别结果翻译等级。0：不返回翻译结果。 1：识别出完整句子时返回翻译结果。 2：识别出中间结果及完整句子时返回翻译结果。默认是1。', 'description' => 'Translation Level for single-channel detection or multi-channel mixed stream detection results.  '."\n"
                                .'0: Do not return translation results.  '."\n"
                                .'1: Return translation results when a complete sentence is detected.  '."\n"
                                .'2: Return translation results for both intermediate results and complete sentences. The default value is 1.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '2', 'default' => '1'],
                            'TranslateActiveResultLevel' => ['title' => '多通道Active流识别结果翻译等级。0：不返回翻译结果。 1：识别出完整句子时返回翻译结果。 2：识别出中间结果及完整句子时返回翻译结果。默认是1。', 'description' => 'Translation Level for multi-channel Active stream recognition results. 0: Do not return translation results. 1: Return translation results when a complete sentence is recognized. 2: Return translation results for both intermediate and complete sentences. The default value is 1.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '2', 'default' => '1'],
                            'RealtimeResultWordsEnabled' => ['title' => '会中识别消息是否包含words信息，默认是true。', 'description' => 'Whether the in-meeting recognition message includes words information. The default value is true.', 'type' => 'boolean', 'required' => false, 'example' => 'true', 'default' => 'true'],
                            'RealtimeResultMeetingInfoEnabled' => ['title' => '会中识别消息结果header中是否包含MeetingKey、MeetingId，默认是false。', 'description' => 'Specifies whether MeetingKey and MeetingId are included in the header of real-time recognition message results during the meeting. The default value is false.', 'type' => 'boolean', 'required' => false, 'example' => 'true', 'default' => 'false'],
                            'Tags' => ['type' => 'object', 'required' => false, 'description' => 'System extension: tag  ', 'title' => '', 'example' => ''],
                            'AsrParams' => ['type' => 'object', 'required' => false, 'description' => 'Additional parameters for ASR transcription, such as vocabulary_id for hotwords.  ', 'example' => '{'."\n"
                                .'  "vocabulary_id": "e2a9a9be3128417fb4d181ebfbe8****"'."\n"
                                .'}', 'title' => ''],
                            'LabParams' => ['type' => 'object', 'required' => false, 'description' => 'System extension: experiment transcription parameters', 'title' => '', 'example' => ''],
                            'AbilityParams' => ['type' => 'object', 'required' => false, 'description' => 'Capability extension', 'title' => '', 'example' => ''],
                        ],
                        'required' => false,
                        'example' => '',
                    ],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => 'Schema of Response',
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['title' => '', 'description' => 'Request ID, for joint debugging only.  ', 'type' => 'string', 'example' => '35124E1C-AE99-5D6C-A52E-BD689D8D****'],
                            'Code' => ['title' => '', 'description' => 'Status code.  ', 'type' => 'string', 'example' => '0'],
                            'Message' => ['title' => '', 'description' => 'Status description.  ', 'type' => 'string', 'example' => 'Success.'],
                            'Data' => [
                                'title' => '',
                                'description' => 'Returned object.  ',
                                'type' => 'object',
                                'properties' => [
                                    'MeetingId' => ['title' => '', 'description' => 'Meeting ID.  ', 'type' => 'string', 'example' => 'f7de74778d94422283534102dfc0****'],
                                    'MeetingJoinUrl' => ['title' => '', 'description' => 'Audio ingest URL for the meeting.  ', 'type' => 'string', 'example' => 'wss://tingwu-realtime-cn-beijing.aliyuncs.com/api/ws/v1?mc=****'],
                                    'MeetingKey' => ['title' => '', 'description' => 'Meeting identity set by the User when creating the meeting.  ', 'type' => 'string', 'example' => 'meeting_123'],
                                ],
                                'example' => '',
                            ],
                        ],
                        'example' => '',
                    ],
                ],
            ],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"35124E1C-AE99-5D6C-A52E-BD689D8D****\\",\\n  \\"Code\\": \\"0\\",\\n  \\"Message\\": \\"Success.\\",\\n  \\"Data\\": {\\n    \\"MeetingId\\": \\"f7de74778d94422283534102dfc0****\\",\\n    \\"MeetingJoinUrl\\": \\"wss://tingwu-realtime-cn-beijing.aliyuncs.com/api/ws/v1?mc=****\\",\\n    \\"MeetingKey\\": \\"meeting_123\\"\\n  }\\n}","type":"json"}]',
            'title' => 'Create a real-time meeting  ',
            'changeSet' => [
                ['createdAt' => '2023-05-16T15:41:27.000Z', 'description' => 'Request parameters changed, Response parameters changed'],
                ['createdAt' => '2022-11-07T03:01:39.000Z', 'description' => 'Request parameters changed'],
                ['createdAt' => '2022-10-20T11:18:30.000Z', 'description' => 'Request parameters changed, Response parameters changed'],
                ['createdAt' => '2022-10-08T22:47:31.000Z', 'description' => 'Request parameters changed, Response parameters changed'],
                ['createdAt' => '2022-09-22T07:26:27.000Z', 'description' => 'Request parameters changed'],
                ['createdAt' => '2022-09-21T02:44:37.000Z', 'description' => 'OpenAPI offline'],
            ],
            'ramActions' => [
                [
                    'operationType' => '',
                    'ramAction' => [
                        'action' => 'tingwu:CreateMeetingTrans',
                        'authLevel' => 'operate',
                        'actionConditions' => [],
                        'resources' => [
                            ['validationType' => 'always', 'product' => 'NlsTingwu', 'resourceType' => 'All Resource', 'arn' => '*'],
                        ],
                    ],
                ],
            ],
        ],
        'GetFileTrans' => [
            'summary' => 'Query audio and video transcription job information.',
            'path' => '/openapi/file-trans/{TransId}',
            'methods' => ['get'],
            'schemes' => ['http', 'https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'produces' => ['application/json'],
            'operationType' => 'read',
            'deprecated' => false,
            'systemTags' => ['operationType' => 'get'],
            'parameters' => [
                [
                    'name' => 'TransId',
                    'in' => 'path',
                    'schema' => ['title' => '', 'description' => 'Job ID.', 'type' => 'string', 'required' => true, 'example' => 'trans_123'],
                ],
            ],
            'responses' => [
                200 => [
                    'headers' => [],
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => 'Schema of Response',
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['title' => '', 'description' => 'Request ID, used only for joint debugging.', 'type' => 'string', 'example' => '35124E1C-AE99-5D6C-A52E-BD689D8D****'],
                            'Code' => ['title' => '', 'description' => 'Status code.', 'type' => 'string', 'example' => '0'],
                            'Message' => ['title' => '', 'description' => 'Status description.', 'type' => 'string', 'example' => 'Success.'],
                            'Data' => [
                                'title' => '',
                                'description' => 'Returned object.',
                                'type' => 'object',
                                'properties' => [
                                    'TransId' => ['title' => '', 'description' => 'Job ID.', 'type' => 'string', 'example' => 'f7de74778d94422283534102dfc0****'],
                                    'TransStatus' => ['title' => '', 'description' => 'Job Status.  '."\n"
                                        .'ONGOING: The job is in progress.  '."\n"
                                        .'COMPLETED: The job is completed.  '."\n"
                                        .'FAILED: The job failed.  '."\n"
                                        .'INVALID: Invalid job.', 'type' => 'string', 'example' => 'ONGOING'],
                                    'TransKey' => ['title' => '', 'description' => 'The task identifier set by the User when creating the Job.', 'type' => 'string', 'example' => 'trans_123'],
                                ],
                                'example' => '',
                            ],
                        ],
                        'example' => '',
                    ],
                ],
            ],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"35124E1C-AE99-5D6C-A52E-BD689D8D****\\",\\n  \\"Code\\": \\"0\\",\\n  \\"Message\\": \\"Success.\\",\\n  \\"Data\\": {\\n    \\"TransId\\": \\"f7de74778d94422283534102dfc0****\\",\\n    \\"TransStatus\\": \\"ONGOING\\",\\n    \\"TransKey\\": \\"trans_123\\"\\n  }\\n}","type":"json"}]',
            'title' => 'Query file transcription job status',
            'changeSet' => [
                ['createdAt' => '2022-10-20T11:18:30.000Z', 'description' => 'Request parameters changed, Response parameters changed'],
                ['createdAt' => '2022-10-08T22:47:31.000Z', 'description' => 'Response parameters changed'],
                ['createdAt' => '2022-09-21T02:44:37.000Z', 'description' => 'OpenAPI offline'],
            ],
            'ramActions' => [
                [
                    'operationType' => 'get',
                    'ramAction' => [
                        'action' => 'tingwu:GetFileTrans',
                        'authLevel' => 'operate',
                        'actionConditions' => [],
                        'resources' => [
                            ['validationType' => 'always', 'product' => 'NlsTingwu', 'resourceType' => 'All Resource', 'arn' => '*'],
                        ],
                    ],
                ],
            ],
        ],
        'GetMeetingTrans' => [
            'summary' => 'Query real-time meeting information.',
            'path' => '/openapi/meeting-trans/{MeetingId}',
            'methods' => ['get'],
            'schemes' => ['http', 'https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'consumes' => [],
            'produces' => ['application/json'],
            'operationType' => 'read',
            'deprecated' => false,
            'systemTags' => ['operationType' => 'get'],
            'parameters' => [
                [
                    'name' => 'MeetingId',
                    'in' => 'path',
                    'schema' => ['title' => '', 'description' => 'Meeting ID.', 'type' => 'string', 'required' => true, 'example' => 'f7de74778d94422283534102dfc0****'],
                ],
            ],
            'responses' => [
                200 => [
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => 'Schema of Response',
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['title' => '', 'description' => 'Request ID, used only for joint debugging.', 'type' => 'string', 'example' => '35124E1C-AE99-5D6C-A52E-BD689D8D****'],
                            'Code' => ['title' => '', 'description' => 'Status code.', 'type' => 'string', 'example' => '0'],
                            'Message' => ['title' => '', 'description' => 'Status description.', 'type' => 'string', 'example' => 'Success.'],
                            'Data' => [
                                'title' => '',
                                'description' => 'Returned object.',
                                'type' => 'object',
                                'properties' => [
                                    'MeetingId' => ['title' => '', 'description' => 'Meeting ID.', 'type' => 'string', 'example' => 'f7de74778d94422283534102dfc0****'],
                                    'MeetingStatus' => ['title' => '', 'description' => 'Meeting status.  '."\n"
                                        .'NEW: New meeting.  '."\n"
                                        .'ONGOING: Meeting transcription in progress.  '."\n"
                                        .'PAUSED: Meeting transcription paused.  '."\n"
                                        .'PRE_COMPLETE: Post-meeting intelligent extraction in progress after transcription ends.  '."\n"
                                        .'COMPLETED: Meeting completed.  '."\n"
                                        .'FAILED: Post-meeting intelligent extraction failed after transcription ends.  '."\n"
                                        .'INVALID: Invalid meeting.', 'type' => 'string', 'example' => 'COMPLETED'],
                                    'MeetingKey' => ['title' => '', 'description' => 'Meeting identity set by the User when creating the meeting.', 'type' => 'string', 'example' => 'meeting_123'],
                                ],
                                'example' => '',
                            ],
                        ],
                        'example' => '',
                    ],
                ],
            ],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"35124E1C-AE99-5D6C-A52E-BD689D8D****\\",\\n  \\"Code\\": \\"0\\",\\n  \\"Message\\": \\"Success.\\",\\n  \\"Data\\": {\\n    \\"MeetingId\\": \\"f7de74778d94422283534102dfc0****\\",\\n    \\"MeetingStatus\\": \\"COMPLETED\\",\\n    \\"MeetingKey\\": \\"meeting_123\\"\\n  }\\n}","type":"json"}]',
            'title' => 'Query real-time meeting status',
            'changeSet' => [
                ['createdAt' => '2022-10-20T11:18:30.000Z', 'description' => 'Request parameters changed, Response parameters changed'],
                ['createdAt' => '2022-10-08T22:47:31.000Z', 'description' => 'Response parameters changed'],
                ['createdAt' => '2022-09-21T02:44:37.000Z', 'description' => 'OpenAPI offline'],
            ],
            'ramActions' => [
                [
                    'operationType' => 'get',
                    'ramAction' => [
                        'action' => 'tingwu:GetMeetingTrans',
                        'authLevel' => 'operate',
                        'actionConditions' => [],
                        'resources' => [
                            ['validationType' => 'always', 'product' => 'NlsTingwu', 'resourceType' => 'All Resource', 'arn' => '*'],
                        ],
                    ],
                ],
            ],
        ],
        'StopMeetingTrans' => [
            'summary' => 'End a real-time meeting.',
            'path' => '/openapi/meeting-trans/{MeetingId}/stop',
            'methods' => ['post'],
            'schemes' => ['http', 'https'],
            'security' => [
                [
                    'AK' => [],
                ],
            ],
            'consumes' => ['application/json'],
            'produces' => ['application/json'],
            'operationType' => 'write',
            'deprecated' => false,
            'systemTags' => [],
            'parameters' => [
                [
                    'name' => 'MeetingId',
                    'in' => 'path',
                    'schema' => ['title' => '', 'description' => 'Meeting ID.', 'type' => 'string', 'required' => true, 'example' => 'meeting_123'],
                ],
                [
                    'name' => 'body',
                    'in' => 'body',
                    'style' => 'json',
                    'schema' => [
                        'description' => 'Request body.',
                        'type' => 'object',
                        'properties' => [
                            'MeetingRoleNum' => ['title' => '会后进行识别结果角色区分人数，在AudioOutputEnabled=true、MeetingResultEnabled=true且DocResultEnabled=true 时生效，默认是1。'."\n"
                                .'0：按多人进行角色区分。'."\n"
                                .'1：按1人进行角色区分，即不区分。'."\n"
                                .'2：按2人进行角色区分。', 'description' => 'The number of distinct roles used to differentiate speakers in the post-meeting Classification Result. This parameter takes effect only when AudioOutputEnabled=true, MeetingResultEnabled=true, and DocResultEnabled=true. The default value is 1.  '."\n"
                                .'0: Differentiate roles for multiple speakers.  '."\n"
                                .'1: Treat all speech as from a single speaker (no role differentiation).  '."\n"
                                .'2: Differentiate roles for two speakers.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', 'default' => '1'],
                            'OnlyRoleSplitResult' => ['title' => '会后结果中docResult字段是否只存储角色时间戳映射信息，即不带转写文字结果，默认是false。', 'description' => 'Specifies whether the docResult field in the post-meeting result stores only the role-to-UNIX timestamp mapping information, without transcription text. The default value is false.', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'default' => 'false'],
                        ],
                        'required' => false,
                        'title' => '',
                        'example' => '',
                    ],
                ],
            ],
            'responses' => [
                200 => [
                    'headers' => [],
                    'schema' => [
                        'title' => 'Schema of Response',
                        'description' => 'Schema of Response',
                        'type' => 'object',
                        'properties' => [
                            'RequestId' => ['title' => '', 'description' => 'Request ID, used only for joint debugging.', 'type' => 'string', 'example' => '35124E1C-AE99-5D6C-A52E-BD689D8D****'],
                            'Code' => ['title' => '', 'description' => 'Status code.', 'type' => 'string', 'example' => '0'],
                            'Message' => ['title' => '', 'description' => 'Status description.', 'type' => 'string', 'required' => false, 'example' => 'Success.'],
                            'Data' => [
                                'title' => '',
                                'description' => 'Returned object.',
                                'type' => 'object',
                                'properties' => [
                                    'MeetingId' => ['title' => '', 'description' => 'Meeting ID.', 'type' => 'string', 'example' => 'f7de74778d94422283534102dfc0****'],
                                    'MeetingStatus' => ['title' => '', 'description' => 'Meeting status.  '."\n"
                                        .'NEW: New meeting.  '."\n"
                                        .'ONGOING: Meeting transcription in progress.  '."\n"
                                        .'PAUSED: Meeting transcription paused.  '."\n"
                                        .'PRE_COMPLETE: Post-meeting intelligent extraction in progress after transcription ends.  '."\n"
                                        .'COMPLETED: Meeting completed.  '."\n"
                                        .'FAILED: Post-meeting intelligent extraction failed after transcription ends.  '."\n"
                                        .'INVALID: Invalid meeting.', 'type' => 'string', 'example' => 'PRE_COMPLETE'],
                                    'MeetingKey' => ['title' => '', 'description' => 'Meeting identity set by the user when creating the meeting.', 'type' => 'string', 'example' => 'meeting_123'],
                                ],
                                'example' => '',
                            ],
                        ],
                        'example' => '',
                    ],
                ],
            ],
            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"35124E1C-AE99-5D6C-A52E-BD689D8D****\\",\\n  \\"Code\\": \\"0\\",\\n  \\"Message\\": \\"Success.\\",\\n  \\"Data\\": {\\n    \\"MeetingId\\": \\"f7de74778d94422283534102dfc0****\\",\\n    \\"MeetingStatus\\": \\"PRE_COMPLETE\\",\\n    \\"MeetingKey\\": \\"meeting_123\\"\\n  }\\n}","type":"json"}]',
            'title' => 'End Real-Time Meeting',
            'changeSet' => [
                ['createdAt' => '2022-10-20T11:18:30.000Z', 'description' => 'Request parameters changed, Response parameters changed'],
                ['createdAt' => '2022-10-08T22:47:31.000Z', 'description' => 'Response parameters changed'],
                ['createdAt' => '2022-09-21T02:44:37.000Z', 'description' => 'OpenAPI offline'],
            ],
            'ramActions' => [
                [
                    'operationType' => '',
                    'ramAction' => [
                        'action' => 'tingwu:StopMeetingTrans',
                        'authLevel' => 'operate',
                        'actionConditions' => [],
                        'resources' => [
                            ['validationType' => 'always', 'product' => 'NlsTingwu', 'resourceType' => 'All Resource', 'arn' => '*'],
                        ],
                    ],
                ],
            ],
        ],
    ],
    'endpoints' => [
        ['regionId' => 'cn-beijing', 'regionName' => 'China (Beijing)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'tingwu.cn-beijing.aliyuncs.com', 'endpoint' => 'tingwu.cn-beijing.aliyuncs.com', 'vpc' => 'tingwu-vpc.cn-beijing.aliyuncs.com'],
    ],
    'errorCodes' => [
        ['code' => 'BRK.InvalidAppKey', 'message' => 'Invalid app key.', 'http_code' => 400, 'description' => 'Invalid project app key.'],
        ['code' => 'BRK.InvalidAudioBitRate', 'message' => 'Invalid audio bit rate.', 'http_code' => 400, 'description' => 'Invalid audio sample bit depth.'],
        ['code' => 'BRK.InvalidAudioFormat', 'message' => 'Invalid audio format.', 'http_code' => 400, 'description' => 'Invalid audio encoding format.'],
        ['code' => 'BRK.InvalidAudioPackage', 'message' => 'Invalid audio package.', 'http_code' => 400, 'description' => 'Invalid audio packaging mode.'],
        ['code' => 'BRK.InvalidAudioSampleRate', 'message' => 'Invalid audio sample rate.', 'http_code' => 400, 'description' => 'Invalid audio sample rate.'],
        ['code' => 'BRK.InvalidLanguage', 'message' => 'Invalid language.', 'http_code' => 400, 'description' => 'Invalid language model.'],
        ['code' => 'BRK.InvalidOssBucket', 'message' => 'Invalid oss bucket.', 'http_code' => 400, 'description' => 'Invalid OSS bucket.'],
        ['code' => 'BRK.InvalidOssPath', 'message' => 'Invalid oss path.', 'http_code' => 400, 'description' => 'Invalid OSS path.'],
        ['code' => 'BRK.InvalidOutputEnabledSetting', 'message' => 'Invalid output enabled setting.', 'http_code' => 400, 'description' => 'Invalid result return switch settings.'],
        ['code' => 'BRK.InvalidResultLevelSetting', 'message' => 'Invalid result level setting.', 'http_code' => 400, 'description' => 'Invalid result return level settings.'],
        ['code' => 'BRK.InvalidRoleSplitNum', 'message' => 'Invalid roleSplitNum.', 'http_code' => 400, 'description' => 'Invalid roleSplitNum value.'],
        ['code' => 'BRK.InvalidService', 'message' => 'Invalid service.', 'http_code' => 400, 'description' => 'The service has not been enabled under the account.'],
        ['code' => 'BRK.InvalidTenant', 'message' => 'Invalid tenant.', 'http_code' => 400, 'description' => 'The service has not been enabled under the account, or an overdue payment exists.'],
        ['code' => 'BRK.OverdueService', 'message' => 'Overdue service.', 'http_code' => 400, 'description' => 'The service has not been enabled under the account, or an overdue payment exists.'],
        ['code' => 'BRK.OverdueTenant', 'message' => 'Overdue tenant.', 'http_code' => 400, 'description' => 'The service has not been enabled under the account, or an overdue payment exists.'],
        ['code' => 'BRK.ServiceLinkedRoleNotExist', 'message' => 'ServiceLinkedRole AliyunServiceRoleForTingwuPaaS not exist.', 'http_code' => 400, 'description' => 'The service-linked role has not been created.'],
        ['code' => 'ServerError', 'message' => 'Server error.', 'http_code' => 500, 'description' => 'A system error occurred.'],
    ],
    'changeSet' => [
        [
            'apis' => [
                ['description' => 'Request parameters changed', 'api' => 'CreateFileTrans'],
            ],
            'createdAt' => '2023-08-03T14:00:45.000Z',
            'description' => '',
        ],
        [
            'apis' => [
                ['description' => 'Request parameters changed', 'api' => 'CreateFileTrans'],
                ['description' => 'Request parameters changed, Response parameters changed', 'api' => 'CreateMeetingTrans'],
            ],
            'createdAt' => '2023-05-16T15:41:32.000Z',
            'description' => '',
        ],
        [
            'apis' => [
                ['description' => 'Request parameters changed', 'api' => 'CreateFileTrans'],
            ],
            'createdAt' => '2023-04-21T03:07:48.000Z',
            'description' => '',
        ],
        [
            'apis' => [
                ['description' => 'Request parameters changed', 'api' => 'CreateFileTrans'],
            ],
            'createdAt' => '2022-12-16T02:19:33.000Z',
            'description' => '修改创建音视频文件转写参数AudioRoleNum的参数说明',
        ],
        [
            'apis' => [
                ['description' => 'Request parameters changed', 'api' => 'CreateFileTrans'],
                ['description' => 'Request parameters changed', 'api' => 'CreateMeetingTrans'],
            ],
            'createdAt' => '2022-11-07T03:03:19.000Z',
            'description' => '单用户接口QPS限流100。',
        ],
        [
            'apis' => [
                ['description' => 'Request parameters changed, Response parameters changed', 'api' => 'CreateFileTrans'],
                ['description' => 'Request parameters changed, Response parameters changed', 'api' => 'CreateMeetingTrans'],
                ['description' => 'Request parameters changed, Response parameters changed', 'api' => 'GetFileTrans'],
                ['description' => 'Request parameters changed, Response parameters changed', 'api' => 'GetMeetingTrans'],
                ['description' => 'Request parameters changed, Response parameters changed', 'api' => 'StopMeetingTrans'],
            ],
            'createdAt' => '2022-10-20T11:18:42.000Z',
            'description' => '',
        ],
        [
            'apis' => [
                ['description' => 'Request parameters changed', 'api' => 'CreateFileTrans'],
                ['description' => 'Request parameters changed, Response parameters changed', 'api' => 'CreateMeetingTrans'],
                ['description' => 'Response parameters changed', 'api' => 'GetFileTrans'],
                ['description' => 'Response parameters changed', 'api' => 'GetMeetingTrans'],
                ['description' => 'Response parameters changed', 'api' => 'StopMeetingTrans'],
            ],
            'createdAt' => '2022-10-08T22:47:43.000Z',
            'description' => '',
        ],
        [
            'apis' => [
                ['description' => 'Request parameters changed', 'api' => 'CreateFileTrans'],
                ['description' => 'Request parameters changed', 'api' => 'CreateMeetingTrans'],
            ],
            'createdAt' => '2022-09-22T07:26:36.000Z',
            'description' => 'init',
        ],
        [
            'apis' => [
                ['description' => 'OpenAPI offline', 'api' => 'CreateFileTrans'],
                ['description' => 'OpenAPI offline', 'api' => 'CreateMeetingTrans'],
                ['description' => 'OpenAPI offline', 'api' => 'GetFileTrans'],
                ['description' => 'OpenAPI offline', 'api' => 'GetMeetingTrans'],
                ['description' => 'OpenAPI offline', 'api' => 'StopMeetingTrans'],
            ],
            'createdAt' => '2022-09-21T07:55:29.000Z',
            'description' => 'init',
        ],
    ],
    'ram' => [
        'productCode' => 'NlsTingwu',
        'productName' => 'Intelligent Speech Interaction',
        'ramCodes' => ['tingwu'],
        'ramLevel' => 'OPERATION',
        'ramConditions' => [],
        'ramActions' => [
            [
                'apiName' => 'CreateMeetingTrans',
                'description' => '',
                'operationType' => '',
                'ramAction' => [
                    'action' => 'tingwu:CreateMeetingTrans',
                    'authLevel' => 'operate',
                    'actionConditions' => [],
                    'resources' => [
                        ['validationType' => 'always', 'product' => 'NlsTingwu', 'resourceType' => 'All Resource', 'arn' => '*'],
                    ],
                ],
            ],
            [
                'apiName' => 'GetFileTrans',
                'description' => '',
                'operationType' => 'get',
                'ramAction' => [
                    'action' => 'tingwu:GetFileTrans',
                    'authLevel' => 'operate',
                    'actionConditions' => [],
                    'resources' => [
                        ['validationType' => 'always', 'product' => 'NlsTingwu', 'resourceType' => 'All Resource', 'arn' => '*'],
                    ],
                ],
            ],
            [
                'apiName' => 'CreateFileTrans',
                'description' => '',
                'operationType' => '',
                'ramAction' => [
                    'action' => 'tingwu:CreateFileTrans',
                    'authLevel' => 'operate',
                    'actionConditions' => [],
                    'resources' => [
                        ['validationType' => 'always', 'product' => 'NlsTingwu', 'resourceType' => 'All Resource', 'arn' => '*'],
                    ],
                ],
            ],
            [
                'apiName' => 'StopMeetingTrans',
                'description' => '',
                'operationType' => '',
                'ramAction' => [
                    'action' => 'tingwu:StopMeetingTrans',
                    'authLevel' => 'operate',
                    'actionConditions' => [],
                    'resources' => [
                        ['validationType' => 'always', 'product' => 'NlsTingwu', 'resourceType' => 'All Resource', 'arn' => '*'],
                    ],
                ],
            ],
            [
                'apiName' => 'GetMeetingTrans',
                'description' => '',
                'operationType' => 'get',
                'ramAction' => [
                    'action' => 'tingwu:GetMeetingTrans',
                    'authLevel' => 'operate',
                    'actionConditions' => [],
                    'resources' => [
                        ['validationType' => 'always', 'product' => 'NlsTingwu', 'resourceType' => 'All Resource', 'arn' => '*'],
                    ],
                ],
            ],
        ],
        'resourceTypes' => [],
    ],
];