# 接口简介即梦同款S2.0 PRO 视频生成API，支持文生视频和图生视频，深度理解文字与图像指令，生成的视频视觉流畅度极佳。支持对多维参数进行精细调控，为创意表达带来专业级的视频生成体验 * **高语义遵循：** 具有极高的“提示词遵循能力”，支持输入很复杂的提示词（例如镜头切换、人物连续动作、情绪演绎、运镜控制） * **动效流畅：** 动作效果流畅自然，整体视频效果结构稳定 * **画面一致性：** 支持保持风格及主体一致性 # prompt建议 * 建议1：明确运镜方式运镜决定观众视觉焦点和故事情感节奏，明确、精炼且有序的镜头指导能让模型构建出想要的画面，增强视频视觉效果。 > 例如，想呈现一个海底美人鱼在游动，就不能仅仅只描写平面上的“游”，而是把镜头的动态描述清楚：“镜头围绕着女孩360旋转……”。 * 建议2：明确行动逻辑一个好故事需清晰的起承转合，描述连续动作时要清晰连贯，用顺序词指明角色行动及顺序，确保动作顺畅衔接，创造真实引人的动态效果 > 例如，蓝色毛绒玩具在超市里拖地，结果拖把洒出好多五颜六色的粉末，接着把粉末洒向镜头前，镜头随之穿过粉末 * 建议3：匹配多镜头组合当视频由多个镜头组成时，易出现内容不匹配错位，可给每个镜头编号并匹配描述，在镜头不错位前提下，把运动和细节描述清楚以获得更符合预期的效果 > 例如： > 第一个镜头\-全景：身穿宇航服的狗狗左右环顾 > 第二个镜头\-近景：宇航员狗狗向操作台走去 > 第三个镜头\-特写：宇航员狗狗伸手去按操作界面 * 建议4：文字描述精准模型虽有文字理解能力，但需精准描述传达真实想法，避免含糊不清和过度堆砌关键词，可简化描述调整语言，还可大胆想象，运用特定动词塑造生动视频效果 > 衣服爆发出一团白色泡沫状的物体，仿佛瞬间膨胀或炸裂开来；衣服被气球完全包裹，气球的颜色以橙色、白色和银色为主，层层叠叠地围绕身体。越来越多不断生长；衣服逐渐化作一团不断扩展的巨大银色丝球，闪烁着光泽，呈现出无尽生长的动态；衣服像气球般迅速膨胀，逐渐充满周围的空间，随后开始缓缓泄气；衣服变成很多个银色的气球，飞起来，然后散落在地面上 # 服务开通 * 视觉台视觉[开通服务](https://console.volcengine.com/ai/ability/detail/10)： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_06706827f210f4d481e8dbc5648b3314.png) # 请求说明 |名称 |内容 | |---|---| |接口地址 |[https://visual.volcengineapi.com](https://visual.volcengineapi.com/) | |请求方式 |POST | |Content\-Type |application/json | ## 提交任务 ### **提交任务请求参数** #### **Query参数** :::tip 拼接到url后的参数，示例：[https://visual.volcengineapi.com?Action=CVSync2AsyncSubmitTask&Version=2022-08-31](https://visual.volcengineapi.com?Action=CVSync2AsyncSubmitTask&Version=2022-08-31) ::: |参数 |可选/必选 |类型 |说明 | |---|---|---|---| |Action |必选 |String |接口名，取值：CVSync2AsyncSubmitTask | |Version |必选 |String |版本号，取值：2022\-08\-31 | #### **Header参数** :::warning 本服务固定值：**Region为cn\-north\-1，Service为cv** ::: 主要用于鉴权，详见 [公共参数](https://www.volcengine.com/docs/6369/67268) \- 签名参数 \- 在Header中的场景部分 #### **Body参数** :::warning 业务请求参数，放到request.body中，MIME\-Type为**application/json** ::: |名称 |类型 |必选 |描述 | |---|---|---|---| |req_key |string |是 |服务标识，取固定值: jimeng_vgfm_i2v_l20 | |binary_data_base64 |array of string |是（二选一，优先生效） |图片Base64数组 | |image_urls |array of string |是（二选一） |图片链接数组 | |prompt |string |否 |生成视频的的提示词，支持中英文，150字符以内，prompt书写参考上方描述，最好与输入图片内容匹配 | |seed |int |否 |随机种子，作为确定扩散初始状态的基础，默认\-1（随机）。若随机种子为相同正整数且其他参数均一致，则生成内容极大概率效果一致|\ | | | |[\-1~2^64\-1]，默认值：\-1|\ | | | ||\ | | | |* \-1时，会随机生成一个种子。|\ | | | |* 其他即为正常取值 | |aspect_ratio|string |是 |参数值：['16:9','4:3','1:1','3:4','9:16','21:9','9:21']：|\ | | | ||\ | | | |* '16:9','4:3','1:1','3:4','9:16','21:9','9:21'：均为标准比例，输入相应比例，则按比例输出|\ | | | ||\ | | | |:::tip 使用建议：输入图片需要进行前置尺寸检测（需调用方实现），判断与标准比例中哪个更为接近，然后传入相应标准比例值|\ | | | ||\ | | | |:::| ### 提交任务返回参数 #### **通用返回参数** 请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) #### **业务返回参数** :::tip 重点关注data 字段，其他字段为公共返回 ::: |字段 |类型 |说明 | |---|---|---| |task_id |string |任务ID，用于查询结果 | ### 提交任务请求&返回完整示例 **请求示例：** ```JSON { "req_key": "jimeng_vgfm_i2v_l20", "image_urls":[ "https://xxx.jpeg" ] } ``` **返回示例：** ```JSON { "code": 10000, "data": { "task_id": "12345678" }, "message": "Success", "request_id": "20240720103939AF0029465CF6A74E51EC", "status": 10000, "time_elapsed": "104.852309ms" } ``` ## 查询任务 ### **查询任务请求参数** #### **Query参数** :::tip 拼接到url后的参数，示例：[https://visual.volcengineapi.com](https://visual.volcengineapi.com/)[?Action=CVSync2AsyncGetResult&Version=2022-08-31](https://visual.volcengineapi.com?Action=CVGetResult&Version=2022-08-31) ::: |参数 |可选/必选 |类型 |说明 | |---|---|---|---| |Action |必选 |String |接口名，固定值：**CVSync2AsyncGetResult** | |Version |必选 |String |版本号，固定值：**2022\-08\-31** | #### **Header参数** :::warning 本服务固定值：**Region为cn\-north\-1，Service为cv** ::: 主要用于鉴权，详见 [公共参数](https://www.volcengine.com/docs/6369/67268) \- 签名参数 \- 在Header中的场景部分 #### **Body参数** :::warning 业务请求参数，放到request.body中，MIME\-Type为**application/json** ::: |参数 |可选/必选 |类型 |说明 |示例 | |---|---|---|---|---| |req_key |必选 |String |服务标识，取固定值: jimeng_vgfm_i2v_l20 | | |task_id |必选 |String |任务ID，此字段的取值为**提交任务接口**的返回 | | |req_json |可选 |json string |json序列化后的字符串,目前支持隐性水印配置，可在返回结果中添加 |示例："{\"aigc_meta\": {\"content_producer\": \"xxxxxx\", \"producer_id\": \"xxxxxx\", \"content_propagator\": \"xxxxxx\", \"propagate_id\": \"xxxxxx\"}}" | ##### **ReqJson(序列化后的结果再赋值给req_json)** 配置信息 |**参数** |**类型** |**可选/必选** |**说明** | | |---|---|---|---|---| |aigc_meta |AIGCMeta |可选 |隐式标识 |隐式标识验证方式：|\ | | | | ||\ | | | | |https://www.gcmark.com/web/index.html#/mark/check/video|\ | | | | | 验证，先注册帐号上传打标后的视频点击开始检测输出检测结果如下图即代表成功|\ | | | | ||\ | | | | |

|\ | | | | |

|\ | | | | | | ##### AIGCMeta 隐式标识，依据《人工智能生成合成内容标识办法》&《网络安全技术人工智能生成合成内容标识方法》 |名称 |类型 |**可选/必选** |描述 | |---|---|---|---| |content_producer |string |可选 |内容生成服务ID（长度 <= 256字符） | |producer_id |string |必选 |内容生成服务商给此图片数据的唯一ID（长度 <= 256字符） | |content_propagator |string |必选 |内容传播服务商ID（长度 <= 256字符） | |propagate_id |string |可选 |传播服务商给此图片数据的唯一ID（长度 <= 256字符） | ### 查询任务返回参数 #### **通用返回参数** 请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) #### **业务返回参数** :::tip 重点关注data 字段，其他字段为公共返回 ::: |参数名 |类型 |参数说明 |参数示例 | |---|---|---|---| |video_url |string |结果视频url（**视频有效期是1h，视频时长固定为5s**） |"https://xxx.mp4" | |aigc_meta_tagged |bool |隐式标识是否打标成功 | | ### 查询任务请求&返回完整示例 **请求示例：** ```JSON { "req_key": "jimeng_vgfm_i2v_l20", "task_id": "7491596536074305586", "req_json": "{\"aigc_meta\": {\"content_producer\": \"001191440300192203821610000\", \"producer_id\": \"producer_id_test123\", \"content_propagator\": \"001191440300192203821610000\", \"propagate_id\": \"propagate_id_test123\"}}" } ``` **返回示例：** ```JSON { "code": 10000, "data": { "aigc_meta_tagged": true, "binary_data_base64": null, "image_urls": null, "resp_data": "{\"infer_ctx\":{\"algorithm_key\":\"x2v_scheduler_vgfm\",\"app_key\":\"2100265171\",\"created_at\":\"2025-04-11T11:40:17.635029282+08:00\",\"generate_id\":\"\",\"log_id\":\"1\",\"params\":{\"app_id\":\"\",\"aspect_ratio\":\"keep_ratio\",\"common_params\":\"\",\"ddim_steps\":0,\"edit_session_id\":\"\",\"fps\":24,\"frames\":121,\"group_name\":\"\",\"height\":720,\"input_image_url\":\"\",\"is_only_sr\":false,\"is_pe\":false,\"llm_result\":\"\",\"media_source\":\"\",\"n_samples\":0,\"negative_prompt\":\"Worst quality, Normal quality, Low quality, Low res, Blurry, Jpeg artifacts, Grainy, text, logo, watermark, banner, extra digits, signature, subtitling, Bad anatomy, Bad proportions, Deformed, Disconnected limbs, Disfigured, Extra arms, Extra limbs, Extra hands, Fused fingers, Gross proportions, Long neck, Malformed limbs, Mutated, Mutated hands, Mutated limbs, Missing arms, Missing fingers, Poorly drawn hands, Poorly drawn face, Nsfw, Uncensored, Cleavage, Nude, Nipples, Overexposed, Plain background, Grainy, Underexposed, Deformed structures, naked, undressed, ass, big breasts, plump breasts\",\"ori_prompt\":\"\",\"origin_request_id\":\"\",\"output_height\":0,\"output_width\":0,\"pe_result\":\"\",\"predict_tags_result\":\"\",\"rephraser_result\":\"视频中，一个穿着米色针织连体衣的小婴儿坐在地上，开心地笑着。婴儿的双手自然放在身体两侧，背景为浅棕色，营造出温馨的氛围。\",\"req_key\":\"vgfm_i2v_l20\",\"rescale\":0,\"resolution\":\"\",\"scale\":7.5,\"seed\":707611012,\"shift\":12,\"sr_img2img_fix_steps\":0,\"sr_scale\":0,\"sr_strength\":0,\"sr_upscaler\":\"\",\"steps\":32,\"strength\":0,\"trace_id\":\"\",\"translate_negative_prompt\":\"\",\"translate_prompt\":\"\",\"use_pre_llm\":true,\"use_prompt_aug\":false,\"use_sr\":false,\"version_id\":\"\",\"video_url\":\"https://tosv.byted.org/obj/ic-cv-seed-t2v/x2v/e0357a858c49832d48617242604ee5e9b24f6f6c26819da0f81001d3834ed633_0.mp4\",\"vlm_edit\":\"\",\"vlm_input\":\"\",\"vlm_output\":\"\",\"width\":1280},\"request_id\":\"e0357a858c49832d48617242604ee5e9b24f6f6c26819da0f81001d3834ed633\",\"session_id\":\"\",\"time_stamp\":\"1744342817\"},\"rephraser_result\":\"视频中，一个穿着米色针织连体衣的小婴儿坐在地上，开心地笑着。婴儿的双手自然放在身体两侧，背景为浅棕色，营造出温馨的氛围。\",\"request_id\":\"e0357a858c49832d48617242604ee5e9b24f6f6c26819da0f81001d3834ed633\",\"urls\":[\"https://tosv.byted.org/obj/ic-cv-seed-t2v/x2v/e0357a858c49832d48617242604ee5e9b24f6f6c26819da0f81001d3834ed633_0.mp4\"],\"vid\":[\"v020adg10005cvs8u87og65vrishdpcg\"],\"video_meta\":[\"{\\\"bitrate\\\":1791774,\\\"duration\\\":5.041667,\\\"file_type\\\":\\\"video\\\",\\\"format\\\":\\\"MP4\\\",\\\"height\\\":1200,\\\"md5\\\":\\\"82e0c0f7ce7d45a54d34214ffce07b9e\\\",\\\"origin_height\\\":1200,\\\"origin_width\\\":752,\\\"size\\\":1129191,\\\"uri\\\":\\\"tos-cn-v-242bcc/ow4LAeDAAEPAFDW8FEfCr3gMyf5BjIVkoEBZDE\\\",\\\"width\\\":752}\"]}", "status": "done", "video_url": "https://xxx.mp4" }, "message": "Success", "request_id": "20250411115207A6A6DFCBB50D4C811F98", "status": 10000, "time_elapsed": "84.460172ms" } ``` ## 错误码 ### **通用错误码** 请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) ### **业务错误码** |HttpCode |错误码 |错误消息 |描述 |是否需要重试 | |---|---|---|---|---| |200 |10000 |无 |请求成功 |不需要 | |400 |50411 |Pre Img Risk Not Pass |输入图片前审核未通过 |不需要 | |400 |50511 |Post Img Risk Not Pass |输出图片后审核未通过 |可重试 | |400 |50412 |Text Risk Not Pass |输入文本前审核未通过 |不需要 | |400 |50512 |Post Text Risk Not Pass |输出文本后审核未通过 |不需要 | |400 |50413 |Post Text Risk Not Pass |输入文本含敏感词、版权词等审核不通过 |不需要 | |400 |50516 | Post Video Risk Not Pass |输出视频后审核未通过 |可重试 | |400 |50517 |Post Audio Risk Not Pass |输出音频后审核未通过 |可重试 | |400 |50518 |Pre Img Risk Not Pass: Copyright |输入版权图前审核未通过 |不需要 | |400 |50519 |Post Img Risk Not Pass: Copyright |输出版权图后审核未通过 |可重试 | |400 |50520 |Risk Internal Error |审核服务异常 |不需要 | |400 |50521 |Antidirt Internal Error |版权词服务异常 |不需要 | |400 |50522 |Image Copyright Internal Error |版权图服务异常 |不需要 | |429 |50429 |Request Has Reached API Limit, Please Try Later |QPS超限 |可重试 | |429 |50430 |Request Has Reached API Concurrent Limit, Please Try Later |并发超限 |可重试 | |500 |50500 |Internal Error |内部错误 |可重试 | |500 |50501 |Internal RPC Error |内部算法错误 |可重试 | ## 接入说明 ### SDK使用说明请参考[SDK使用说明](https://www.volcengine.com/docs/6444/1340578) ### HTTP方式接入说明请参考[HTTP请求示例](https://www.volcengine.com/docs/6444/1390583)

即梦AI