> ## Documentation Index > Fetch the complete documentation index at: https://docs.bigmodel.cn/llms.txt > Use this file to discover all available pages before exploring further. # CogVideoX-3 ## 概览 CogVideoX-3 新增首尾帧生成功能，画面稳定度、清晰度大幅提升，主体大幅度运动流畅自然，指令遵循与物理真实模拟更佳，还提升了高清现实及 3D 风格场景表现。 }> 5s, 10s }> 支持多分辨率，最高4K }> 1 元 / 次 }> 图像、文本、首尾帧 }> 视频 ## 推荐场景 输入产品图或文案，快速生成多风格动态广告，支持场景切换、真实光影渲染。 上传景区实拍图和宣传语，一键生成沉浸式文旅短片，真实还原自然景观。 输入动漫角色设定图、场景草图或剧情文案，快速生成流畅的动漫短片，保留动漫独特画风与质感。 将单帧图或文本脚本输出为画面稳、动作自然的短视频，可模拟连贯镜头运动，还原真实物理交互，覆盖现实 / 3D 风格。 ## 使用资源 快速测试模型在业务场景上的效果 API 调用方式 ## 详细介绍 CogVideoX-3 生成的视频主体清晰、画面稳定，畸形问题减少，还支持主体进行大幅度运动，让动态表现更自然流畅。
Prompt 视频
花瓣被风吹起，不断的旋转变成一个人
哪吒开心的喝了一口酒，然后展示酒的品牌
深度理解文本指令意图，精准还原创意需求，无论是让角色完成特定动作，还是模拟自然物理现象，都能贴合现实逻辑呈现。
Prompt 视频
一双手拿着一把水果刀，在一片一片地切一个完整的红色西红柿
开放式办公室里，一名员工正低头玩手机，突然经理出现拍了拍他的肩膀，他吓得赶紧收起手机
面对现实风格，可打造如实拍般的高清质感；切换 3D 风格时，可精准塑造立体形态与场景氛围，轻松驾驭多种风格。
Prompt 视频
仰拍镜头拍窦娥与天空，窦娥是被冤的中国古代女子，此时她在仰头喊。六月烈日当空时，白色大雪从天空落下，与血色痕迹碰到后散开。衣服微动，3D 粒子风。
一只帅气的拟人化雪豹，穿着白色的豹纹时尚大衣，超级蓬松，毛绒绒，厚实，尊贵，T 台走秀，超高清，电影质感，大片即视感，维秘秀。T 台两边坐满观众拍照。
支持用户提供首帧图片和尾帧图片，即可自动生成连贯转场的视频，让静态帧自然衔接为动态叙事，串联完整创意。
Prompt 首帧 尾帧 视频
龙王转成敖丙，水墨风晕染，主体转体缓缓变身，突出变身细节，旋转运镜，过渡丝滑、流畅自然 首帧 尾帧
角色双手拿枪对着电脑屏幕疯狂射击，电脑燃烧爆炸变成碎片飞溅，办公室灯光闪烁 首帧 尾帧
## 调用示例 **安装 SDK** ```bash theme={null} # 安装最新版本 pip install zai-sdk # 或指定版本 pip install zai-sdk==0.2.3 ``` **验证安装** ```python theme={null} import zai print(zai.__version__) ``` **调用示例** ```Python theme={null} from zai import ZhipuAiClient client = ZhipuAiClient(api_key="YOUR_API_KEY") # Generate video response = client.videos.generations( model="cogvideox-3", prompt="A cat is playing with a ball.", quality="quality", # Output mode, "quality" for quality priority, "speed" for speed priority with_audio=True, # Whether to include audio size="1920x1080", # Video resolution, supports up to 4K (e.g., "3840x2160") fps=30, # Frame rate, can be 30 or 60 ) print(response) # Get video result result = client.videos.retrieve_videos_result(id=response.id) print(result) ``` **安装 SDK** ```bash theme={null} # 安装最新版本 pip install zai-sdk # 或指定版本 pip install zai-sdk==0.2.3 ``` **验证安装** ```python theme={null} import zai print(zai.__version__) ``` **调用示例** ```Python theme={null} from zai import ZhipuAiClient # 初始化客户端，请填写您自己的 APIKey client = ZhipuAiClient(api_key="YOUR_API_KEY") # 定义图片的URL地址 image_url = "https://img.iplaysoft.com/wp-content/uploads/2019/free-images/free_stock_photo.jpg" # 替换为您的图片 URL 地址 # 调用视频生成接口 response = client.videos.generations( model="cogvideox-3", # 使用的视频生成模型 image_url=image_url, # 提供的图片 URL 地址或者 Base64 编码 prompt="让画面动起来", quality="quality", # 输出模式，"quality"为质量优先，"speed"为速度优先 with_audio=True, size="1920x1080", # 视频分辨率，支持最高4K（如: "3840x2160"） fps=30, # 帧率，可选为30或60 ) # 打印返回结果 print(response) # Get video result result = client.videos.retrieve_videos_result(id=response.id) print(result) ``` **安装 SDK** ```bash theme={null} # 安装最新版本 pip install zai-sdk # 或指定版本 pip install zai-sdk==0.2.3 ``` **验证安装** ```python theme={null} import zai print(zai.__version__) ``` **调用示例** ```Python theme={null} from zai import ZhipuAiClient # 初始化客户端，请填写您自己的APIKey client = ZhipuAiClient(api_key="YOUR_API_KEY") # 定义首帧和尾帧的URL地址 sample_first_frame = "https://cdn.bigmodel.cn/markdown/1752547801491cogvideo4.png" sample_last_frame = "https://cdn.bigmodel.cn/markdown/1752547813297cogvideo5.png" # 调用视频生成接口（假设支持 image_urls） response = client.videos.generations( model="cogvideox-3", # 使用的视频生成模型 image_url=[sample_first_frame, sample_last_frame], # 传入首帧和尾帧的 URL 列表 prompt="让画面动起来", quality="quality", # 输出模式，"quality"为质量优先，"speed"为速度优先 with_audio=True, size="1920x1080", # 视频分辨率，支持最高4K（如: "3840x2160"） fps=30, # 帧率，可选为30或60 ) # 打印返回结果 print(response) # Get video result result = client.videos.retrieve_videos_result(id=response.id) print(result) ``` ## 用户并发权益 API 调用会受到速率限制，当前我们限制的维度是请求并发数量（在途请求任务数量）。不同等级的用户并发保障如下。 | V0 | V1 | V2 | V3 | | :- | :- | :- | :- | | 5 | 10 | 15 | 20 |