tencent cloud

Cloud Infinite

문서Cloud InfiniteAPI DocumentationSmart AudioText to SpeechTask Callback

Task Callback

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-09-15 17:39:17

Feature Description

Cloud Infinite (CI) supports customizing a callback URL. After task completion, the system sends an HTTP POST request to this URL with the notification content in the request body. You can learn about task processing progress and status promptly through the configured callback URL so that you can perform other business operations.

Callback Content

After task completion, the system will send the callback content to the callback URL you have set, including the complete node data as follows:
<Response>
    <EventName>TaskFinish</EventName>
    <JobsDetail>
        <Code>Success</Code>
        <CreationTime>2022-06-30T19:33:18+0800</CreationTime>
        <EndTime>2022-06-30T19:33:24+0800</EndTime>
        <JobId>j707f4864f86811ecb90d0b03267ce0e5</JobId>
        <Message/>
        <Operation>
            <MediaInfo>
                <Format/>
                <Stream>
                    <Audio>
                        <CodecName>mp3</CodecName>
                        <SampleRate>16000</SampleRate>
                    </Audio>
                    <Subtitle/>
                    <Video/>
                </Stream>
            </MediaInfo>
            <MediaResult>
                <OutputFile>
                    <Bucket>test-123456789</Bucket>
                    <Md5Info>
                        <Md5>5b2ca33cd7357abb1e0ea29f57544df9</Md5>
                        <ObjectName>/output/aixiaonan.mp3</ObjectName>
                    </Md5Info>
                    <ObjectName>/output/aixiaonan.mp3</ObjectName>
                    <ObjectPrefix/>
                    <Region>ap-chongqing</Region>
                </OutputFile>
            </MediaResult>
            <Output>
                <Bucket>test-123456789</Bucket>
                <Object>output/aixiaonan.mp3</Object>
                <Region>ap-chongqing</Region>
            </Output>
            <TtsConfig>
                <Input>Hello, I'm Aixiaonan. Nice to meet you.</Input>
                <InputType>Text</InputType>
            </TtsConfig>
            <TemplateId>t1f1ae1dfsdc9ds41dsb31632d457ds6s2a</TemplateId>
            <TemplateName>template_tts</TemplateName>
            <UserData>This is my Tts job.</UserData>
            <JobLevel>0</JobLevel>
        </Operation>
        <QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
        <StartTime>2022-06-30T19:33:19+0800</StartTime>
        <State>Success</State>
        <Tag>Tts</Tag>
    </JobsDetail>
</Response>
The data are as follows:
Node Name (Keyword)
Parent Node
Description
Type
Response
None.
Container for saving results
Container
Container node Response content:
Node Name (Keyword)
Parent Node
Description
Type
EventName
Response
Fixed Value, TaskFinish
String
JobsDetail
Response
Submit the text to speech task interface Response.JobsDetail
Container array
If the task is triggered by a workflow, Response.JobsDetail.Input will also include the CosHeaders node, with data type as Container array.
Container node CosHeaders content:
Node Name (Keyword)
Parent Node
Description
Type
Key
Response.JobsDetail.Input.CosHeaders
Custom Header name
String
Value
Response.JobsDetail.Input.CosHeaders
Custom Header value
String
If the task is triggered by a workflow, Response.JobsDetail will also include the Workflow node, with data type as Container.
Container node Workflow content:
Node Name (Keyword)
Parent Node
Description
Type
RunId
Response.Workflow
workflow instance ID
String
WorkflowId
Response.Workflow
workflow ID
String
WorkflowName
Response.Workflow
workflow name
String
Name
Response.Workflow
workflow node name
String

Practical Case

Case 1: Task Callback Triggered by Task Interface

<Response>
    <EventName>TaskFinish</EventName>
    <JobsDetail>
        <Code>Success</Code>
        <CreationTime>2022-06-30T19:33:18+0800</CreationTime>
        <EndTime>2022-06-30T19:33:24+0800</EndTime>
        <JobId>j707f4864f86811ecb90d0b03267ce0e5</JobId>
        <Message/>
        <Operation>
            <MediaInfo>
                <Format/>
                <Stream>
                    <Audio>
                        <CodecName>mp3</CodecName>
                        <SampleRate>16000</SampleRate>
                    </Audio>
                    <Subtitle/>
                    <Video/>
                </Stream>
            </MediaInfo>
            <MediaResult>
                <OutputFile>
                    <Bucket>test-123456789</Bucket>
                    <Md5Info>
                        <Md5>5b2ca33cd7357abb1e0ea29f57544df9</Md5>
                        <ObjectName>/output/aixiaonan.mp3</ObjectName>
                    </Md5Info>
                    <ObjectName>/output/aixiaonan.mp3</ObjectName>
                    <ObjectPrefix/>
                    <Region>ap-chongqing</Region>
                </OutputFile>
            </MediaResult>
            <Output>
                <Bucket>test-123456789</Bucket>
                <Object>output/aixiaonan.mp3</Object>
                <Region>ap-chongqing</Region>
            </Output>
            <TtsConfig>
                <Input>Hello, I'm Aixiaonan. Nice to meet you.</Input>
                <InputType>Text</InputType>
            </TtsConfig>
            <TemplateId>t1f1ae1dfsdc9ds41dsb31632d457ds6s2a</TemplateId>
            <TemplateName>template_tts</TemplateName>
            <UserData>This is my tts job.</UserData>
            <JobLevel>0</JobLevel>
        </Operation>
        <QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
        <StartTime>2022-06-30T19:33:19+0800</StartTime>
        <State>Success</State>
        <Tag>Tts</Tag>
    </JobsDetail>
</Response>

Case 2: Task Callback Triggered by Workflow

<Response>
    <EventName>TaskFinish</EventName>
    <JobsDetail>
        <Code>Success</Code>
        <CreationTime>2022-06-30T19:33:18+0800</CreationTime>
        <EndTime>2022-06-30T19:33:24+0800</EndTime>
        <JobId>j707f4864f86811ecb90d0b03267ce0e5</JobId>
        <Message/>
        <Operation>
            <Input>
                <CosHeaders>
                    <Key>Content-Type</Key>
                    <Value>application/octet-stream</Value>
                </CosHeaders>
                <CosHeaders>
                    <Key>x-cos-request-id</Key>
                    <Value>NjJiZDYwYTFfNjUzYTYyNjRfZjEwZl8xMmZhYzY5</Value>
                </CosHeaders>
                <CosHeaders>
                    <Key>EventName</Key>
                    <Value>cos:ObjectCreated:Put</Value>
                </CosHeaders>
                <CosHeaders>
                    <Key>Size</Key>
                    <Value>265</Value>
                </CosHeaders>
            </Input>
            <MediaInfo>
                <Format/>
                <Stream>
                    <Audio>
                        <CodecName>mp3</CodecName>
                        <SampleRate>16000</SampleRate>
                    </Audio>
                    <Subtitle/>
                    <Video/>
                </Stream>
            </MediaInfo>
            <MediaResult>
                <OutputFile>
                    <Bucket>test-123456789</Bucket>
                    <Md5Info>
                        <Md5>5b2ca33cd7357abb1e0ea29f57544df9</Md5>
                        <ObjectName>/output/aixiaonan.mp3</ObjectName>
                    </Md5Info>
                    <ObjectName>/output/aixiaonan.mp3</ObjectName>
                    <ObjectPrefix/>
                    <Region>ap-chongqing</Region>
                </OutputFile>
            </MediaResult>
            <Output>
                <Bucket>test-123456789</Bucket>
                <Object>output/aixiaonan.mp3</Object>
                <Region>ap-chongqing</Region>
            </Output>
            <TtsConfig>
                <Input>https://test-123456789.cos.ap-chongqing.myqcloud.com/input/text.txt</Input>
                <InputType>Url</InputType>
            </TtsConfig>
            <TemplateId>t1f1ae1dfsdc9ds41dsb31632d457ds6s2a</TemplateId>
            <TemplateName>template_tts</TemplateName>
            <UserData>This is my Tts job.</UserData>
            <JobLevel>0</JobLevel>
        </Operation>
        <QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
        <StartTime>2022-06-30T19:33:19+0800</StartTime>
        <State>Success</State>
        <Tag>Tts</Tag>
        <Workflow>
            <Name>Tts_1581665960537</Name>
            <RunId>ic90edd59f84f11ec9d4f525400a3c59f</RunId>
            <WorkflowId>web6ac56c1ef54dbfa44d7f4103203be9</WorkflowId>
            <WorkflowName>workflow-test</WorkflowName>
        </Workflow>
    </JobsDetail>
</Response>

Case 3: Task Callback Triggered by Workflow in JSON Format

{
    "EventName": "TaskFinish",
    "JobsDetail": [{
        "Code": "Success",
        "CreationTime": "2022-06-30T19:33:18+0800",
        "EndTime": "2022-06-30T19:33:24+0800",
        "JobId": "j707f4864f86811ecb90d0b03267ce0e5",
        "Operation": {
            "Input": {
                "CosHeaders": [{
                        "Key": "Content-Type",
                        "Value": "application/octet-stream"
                    },
                    {
                        "Key": "x-cos-request-id",
                        "Value": "NjJiZDYwYTFfNjUzYTYyNjRfZjEwZl8xMmZhYzY5"
                    },
                    {
                        "Key": "EventName",
                        "Value": "cos:ObjectCreated:Put"
                    },
                    {
                        "Key": "Size",
                        "Value": "265"
                    }
                ]
            },
            "MediaInfo": {
                "Stream": {
                    "Audio": [{
                        "CodecName": "mp3",
                        "SampleRate": "16000"
                    }
                }
            },
            "MediaResult": {
                "OutputFile": {
                    "Bucket": "test-123456789",
                    "Md5Info": [{
                        "Md5": "5b2ca33cd7357abb1e0ea29f57544df9",
                        "ObjectName": "/output/aixiaonan.mp3"
                    }],
                    "ObjectName": ["/output/aixiaonan.mp3"],
                    "Region": "ap-chongqing"
                }
            },
            "Output": {
                "Bucket": "test-123456789",
                "Object": "output/aixiaonan.mp3",
                "Region": "ap-chongqing"
            },
            "TtsConfig": {
                "Input": "https://test-123456789.cos.ap-chongqing.myqcloud.com/input/text.txt",
                "InputType": "Url"
            },
            "TemplateId": "t1f1ae1dfsdc9ds41dsb31632d457ds6s2a",
            "TemplateName": "template_tts",
            "UserData": "This is my Tts job.",
            "JobLevel": 0
        },
        "QueueId": "p2242ab62c7c94486915508540933a2c6",
        "StartTime": "2022-06-30T19:33:19+0800",
        "State": "Success",
        "Tag": "Tts",
        "Workflow": {
            "Name": "Tts_1581665960537",
            "RunId": "ic90edd59f84f11ec9d4f525400a3c59f",
            "WorkflowId": "web6ac56c1ef54dbfa44d7f4103203be9",
            "WorkflowName": "workflow-test"
        }
    }]
}

이전 주제: Submit a Task다음 주제: Creating Templates

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백