示例说明

本示例将使用小剧本《藏在奶茶里的戒指》，完整展示小云雀-短剧漫剧Agent从剧本解析到单集视频合成的调用流程。本示例选用的视频生成模型为「Seedance 2.0 720p」。

藏在奶茶里的戒指.docx

剧本解析

提交任务

输入参数

输出参数

查询任务

输入参数

输出参数

{​
    "code": 10000,​
    "data": {​
        "aigc_meta_tagged": false,​
        "resp_data": "{\"thread_id\":\"ark_3572523320385040940\",\"assets_id\":\"ark_1194097890828\",\"status\":\"Success\",\"script_detail\":{\"OverviewAssetID\":\"1194097890828\",\"ScriptAssetID\":\"1193704634124\",\"CoreElement\":{\"CoreSetting\":\"现代都市爱情求婚故事：陈屿与许知夏是两年前在奶茶店相识的恋人，两年前陈屿在公园向许知夏承诺买一辈子奶茶，两年后的夜晚陈屿在公园许愿池边正式向许知夏求婚\",\"Time\":\"现代都市，两年前至今\",\"MainCharacter\":\"陈屿\",\"Location\":\"街角奶茶店、城市公园步道、公园许愿池\",\"CorePlot\":\"陈屿在奶茶店紧张地等待许知夏，并准备用戒指求婚。许知夏到达后，两人回忆起他们第一次约会时，陈屿就在这里为她点了同款奶茶。\\n许知夏和陈屿在公园步道散步，许知夏询问陈屿为何心事重重。陈屿提及两年前两人在此地许愿的往事，但最终未能鼓起勇气说出求婚的话，只是在心中暗下决心下次不再搞砸。\\n陈屿在许愿池边向许知夏惊喜求婚，他手持钻戒单膝跪地，深情告白。许知夏感动落泪，欣然应允，陈屿为她戴上戒指并紧紧相拥。\\n\",\"Perspective\":\"主角视角第一人称\",\"Summary\":\"陈屿与许知夏相恋多年，这一天对他而言意义非凡。他早早来到两人初次约会的奶茶店，紧张地等待着女友的到来，手中紧握着那枚承载着承诺的戒指。当许知夏出现时，陈屿心中涌起复杂的情感，两人相视而笑，仿佛回到了当年青涩的相识时刻，许知夏发现陈屿为她点的正是初次约会时的那款奶茶，熟悉的味道唤起了美好的回忆。随后，两人在公园步道悠然散步，初秋的微风轻拂，许知夏察觉到陈屿似乎心事重重。陈屿提及两年前两人曾在此许愿的往事，那时的他满怀憧憬却终究未能鼓起勇气说出那句求婚的话，他暗暗发誓这次绝不再搞砸。在许愿池边，陈屿终于下定决心，他单膝跪地，郑重地取出钻戒，深情告白，倾诉着对许知夏的爱意与珍视。许知夏被这突如其来的惊喜感动得落泪，欣然应允了这份真挚的求婚，陈屿为她戴上戒指，两人紧紧相拥，终于迎来了属于他们的幸福时刻。多年等待与忐忑在这一刻化为圆满，陈屿用勇气与真心为这段爱情写下了最美好的承诺。\",\"Style\":\"搞笑\",\"Background\":\"现代都市爱情求婚故事：陈屿与许知夏是两年前在奶茶店相识的恋人，两年前陈屿在公园向许知夏承诺买一辈子奶茶，两年后的夜晚陈屿在公园许愿池边正式向许知夏求婚；地点：街角奶茶店、城市公园步道、公园许愿池；时间：现代都市，两年前至今\",\"EpisodeCount\":3,\"FrequencyCategory\":\"女频\"},\"Settings\":{\"VisualStyle\":\"真人写实, 电影风格, 冷色调\",\"VideoRatio\":\"16:9\"},\"CharacterAssets\":[{\"CharacterID\":\"C1\",\"CharacterName\":\"陈屿\",\"CharacterAssetID\":\"1193719571468\",\"AppearanceCount\":3,\"EpisodeAssetIDs\":[\"1193839593996\",\"1194108855308\",\"1194215545868\"],\"IsMainCharacter\":true},{\"CharacterID\":\"C2\",\"CharacterName\":\"许知夏\",\"CharacterAssetID\":\"1193911234060\",\"AppearanceCount\":3,\"EpisodeAssetIDs\":[\"1193839593996\",\"1194108855308\",\"1194215545868\"],\"Aliases\":[\"知夏\"]}],\"SceneAssets\":[{\"SceneAssetID\":\"1193827913740\",\"EpisodeAssetIDs\":[\"1193839593996\"]},{\"SceneAssetID\":\"1194108981004\",\"EpisodeAssetIDs\":[\"1194108855308\"]},{\"SceneAssetID\":\"1193993438988\",\"EpisodeAssetIDs\":[\"1194215545868\"]}],\"EpisodeAssets\":[{\"EpisodeID\":\"1\",\"EpisodeName\":\"1193704634124-001\",\"EpisodeTitle\":\"奶茶店里的求婚秘密\",\"EpisodeAssetID\":\"1194108855308\",\"StoryboardAssetID\":\"1194110367756\",\"CharacterAssetIDs\":[\"1193719571468\",\"1193911234060\"],\"SceneAssetIDs\":[\"1194108981004\"],\"EpisodeSynopsisAssetID\":\"1193839613452\"},{\"EpisodeID\":\"2\",\"EpisodeName\":\"1193704634124-002\",\"EpisodeTitle\":\"桂香夜语欲言又止\",\"EpisodeAssetID\":\"1193839593996\",\"StoryboardAssetID\":\"1194129613068\",\"CharacterAssetIDs\":[\"1193719571468\",\"1193911234060\"],\"SceneAssetIDs\":[\"1193827913740\"],\"EpisodeSynopsisAssetID\":\"1194129535244\"},{\"EpisodeID\":\"3\",\"EpisodeName\":\"1193704634124-003\",\"EpisodeTitle\":\"许愿池畔浪漫求婚\",\"EpisodeAssetID\":\"1194215545868\",\"StoryboardAssetID\":\"1194002046732\",\"CharacterAssetIDs\":[\"1193719571468\",\"1193911234060\"],\"SceneAssetIDs\":[\"1193993438988\"],\"EpisodeSynopsisAssetID\":\"1193984817420\"}],\"StoryboardBriefs\":[{\"EpisodeID\":\"1\",\"EpisodeAssetID\":\"1194108855308\",\"StoryboardAssetID\":\"1194110367756\"},{\"EpisodeID\":\"2\",\"EpisodeAssetID\":\"1193839593996\",\"StoryboardAssetID\":\"1194129613068\"},{\"EpisodeID\":\"3\",\"EpisodeAssetID\":\"1194215545868\",\"StoryboardAssetID\":\"1194002046732\"}],\"StageStatusMap\":{\"script_overview_analysis\":{\"Status\":3,\"Message\":\"剧本大纲分析成功\"},\"dynamic_form\":{\"Status\":3,\"Message\":\"表单填写成功\"}}},\"charge_count\":9}",​
        "status": "done"​
    },​
    "message": "Success",​
    "request_id": "20260515130726B0DEB99E99E48BF2E1AB",​
    "status": 10000,​
    "time_elapsed": "44.138458ms"​
}​

resp_data 反序列化结果展示

说明

请妥善保存接口返回的 assets_id（资产 ID）、thread_id（会话 ID）及 EpisodeID （剧集 ID），用于后续流程；

图片生成

提交任务

输入参数

输出参数

查询任务

输入参数

输出参数

resp_data 反序列化结果展示

说明

可遍历 character_detail（角色资源详细内容）中的每一组 ExpectRenderImageCount（预期渲染图数量）和 ActualRenderImageCount（实际成功渲染图数量），当存在任意 ExpectRenderImageCount 不等于 ActualRenderImageCount 时表示有角色资源图片生成失败；

同上，可遍历 scene_detail（场景资源详细内容）中的每一组 ExpectRenderImageCount（预期渲染图数量）和 ActualRenderImageCount（实际成功渲染图数量），当存在任意 ExpectRenderImageCount 不等于 ActualRenderImageCount 时表示有场景资源图片生成失败；

生成失败的图片不支持重新生成或上传外部图片；

图片生成失败最常见原因为审核不通过，请检查剧本中是否有涉及敏感身份、职业角色或者不合规的人物特征设定；

单集分镜视频生成

提交任务

输入参数

输出参数

查询任务

输入参数

输出参数

resp_data 反序列化结果展示

说明

可通过遍历 ShotStatusMap（各分镜的状态映射）中的 Status（分镜状态），确认所有分镜是否都成功完成；若存在生成失败的分镜，将无法调用视频合成接口生成最终视频；

当少数分镜生成失败时，可保存失败分镜的 Description（分镜描述）以及图片生成接口返回的图片资源，前往第三方工具重新生成失败的分镜视频；并下载其余生成成功的分镜视频，通过第三方工具进行视频拼接，合成最终视频。

单集视频合成

提交任务

输入参数

输出参数

查询任务

输入参数

输出参数

resp_data 反序列化结果展示

输出视频展示

剧集ID	剧集封面	剧集视频
1		Replay Play 00:00 / 00:23 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

即梦AI