Vidu API申请与使用指南：新手快速上手教程

在调用Vidu API生成视频时，开发者常因身份认证、地域匹配或请求参数配置不完整而受阻。这份全流程指南将帮你精准定位问题，高效完成从权限申请到接口调用的每一步。

一、申请Vidu API访问权限

获取正式的API调用资格是首要且关键的一步，需通过官方渠道完成以确保合规性。

首先，访问Vidu官方网站，点击页面右上角的“Sign In”按钮。注册支持谷歌账户或邮箱登录，新用户需完成邮箱验证。

登录后进入个人中心，找到“Apply for Beta Access”入口并提交内测申请。申请表需详细填写使用场景、月度预估生成量及AI工具使用经验。核心环节是按要求上传本人手持身份证正面照片，系统会自动进行敏感信息脱敏处理。

提交后，审核周期通常为1至3个工作日。审核通过后，账户将获得“Beta Tester”标识，并获赠200初始积分。最后，务必在模型卡片页面点击“立即开通”，确认授权并开通对应地域的Vidu模型服务，至此权限才完全生效。

二、获取并配置API Key与Endpoint

获得权限后，下一步是获取调用凭证。核心原则是：API Key与Endpoint URL必须严格匹配你开通服务的同一地域，跨地域调用将直接失败。

操作路径：进入Vidu控制台的“API管理”或“密钥中心”页面。选择目标地域（如北京、上海或新加坡），点击“创建密钥”生成专属API Key。

同时，复制该地域对应的Endpoint URL。例如，北京地域的地址通常为：https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis。

随后，将API Key配置到开发环境变量或代码中，示例：export DASHSCOPE_API_KEY=sk-xxx。同时确认模型名称与版本：ModelName固定为Vidu，ModelVersion可选q2、q2-pro、q3等。

三、构造HTTP POST请求调用API

Vidu API采用异步处理模式，需遵循“创建任务-轮询结果”的两步流程。

第一步，向配置好的Endpoint发起POST请求。请求头（Header）必须包含：Content-Type: application/json 和 Authorization: Bearer YOUR_API_KEY。

请求体（Body）为JSON格式，必填字段包括：prompt（文本描述）、video_length_seconds（视频时长）、resolution（分辨率，如“1080p”）。若调用首尾帧生成功能，则需额外提供可公开访问的图片URL：first_frame_url和last_frame_url。

请求成功（状态码200）后，返回的JSON中包含task_id。此ID有效期为24小时，请妥善保管以避免重复创建任务。

第二步，使用GET方法轮询地址/api/v1/tasks/{task_id}，持续查询直至返回结果中的status字段变为SUCCEEDED（成功）或FAILED（失败）。

四、使用第三方平台快速测试API

在本地部署前，利用第三方平台可快速验证API连通性与参数准确性。

推荐访问易源平台的Vidu API测试页面，或使用Postman导入官方JSON示例集合。在测试界面，粘贴你的API Key，并选择对应的地域和模型版本。

填入合法的prompt及其他参数后发送请求。观察返回的task_id和status字段。若遇401 Unauthorized错误，通常源于API Key过期或Authorization头配置错误；若为400 Bad Request，则需仔细核对JSON字段拼写及必填项完整性。

测试成功后，平台（如易源）的“我的调用记录”功能会保存完整的请求与响应原始数据，便于与生产环境进行比对和调试。

五、通过腾讯云点播平台调用Vidu模型

对于已拥有腾讯云账号并希望统一管理AIGC视频生成服务的用户，可通过腾讯云点播平台集成调用。

登录腾讯云控制台，进入“点播”服务，找到“AIGC生视频”模块。在创建任务接口（CreateAigcVideoTask）中，需将ModelName参数设为Vidu，并在ModelVersion中指定有效版本，如q2-pro或q3-turbo。

此外，还需传入SubAppId（点播应用ID）、InputInfo（包含prompt或图片URL）、OutputInfo（分辨率与时长）等必要参数。

接口调用成功将返回TaskId，随后通过DescribeAigcVideoTask接口轮询，即可获取最终生成的视频播放地址。请注意，此方式按实际调用量计费：日结客户次日出账，月结客户统一在次月1日结算上月费用。