要让vidu开发者服务稳定运行,须完成鉴权配置、正确传参、处理关键回调并提交内容审核。具体包括:登录平台创建应用(限5个)、获取client_id/client_secret、调用token接口获取access_token;请求需含prompt、model、authorization头;图生文需https公网图且尺寸≤2048×2048;支持max_tokens和style参数;需实现回调处理,校验时间戳防重放,按error_code分类响应;内容上线前须提交审核获review_pass_id并随请求携带。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让Vidu开发者服务在你的应用中稳定运行,必须完成鉴权配置、正确传参、处理关键回调,并通过内容审核流程——漏掉任一环节都会导致服务调用失败或被平台拦截。
完成基础鉴权配置
第一步:登录vivo商业开放平台,使用广告主账户或代理商二代账号进入「应用管理」→「创建应用程序」。
第二步:填写应用名称、图标,勾选「Vidu内容生成服务」权限;注意【单个账号最多创建5个应用,旧应用未删除则无法新建】。
第三步:提交后等待人工审核,通常1~3个工作日完成;审核通过后,在应用详情页获取client_id和client_secret。
第四步:调用鉴权接口POST https://api.vivo.com.cn/v1/oauth2/token,携带client_id、client_secret、grant_type=client_credentials;返回的access_token有效期为2小时,需自行缓存并刷新。
构造合规请求参数
方法一:基础文本生成请求
向POST https://api.vivo.com.cn/v1/vidu/generate发送JSON体,必须包含prompt(非空字符串)、model(当前仅支持vidu-pro-2026)、access_token(放在Header中,键为Authorization: Bearer {token})。
方法二:带图生文请求
image_url字段需为公网可直访问的HTTPS地址,且图片尺寸不能超过2048×2048像素;若URL不可达或格式不支持(如WebP未转JPEG),接口将直接返回400错误。
Vidu视频生成插件(viduq3-pro、viduq3-turbo、viduq2、viduq1)。支持文字转视频、图片转视频、参考转视频以及起始编辑。
方法三:控制输出长度与风格
可选字段max_tokens设为512~2048之间整数;style支持formal/casual/creative三值,传其他值将被忽略并按formal处理。
监听并响应关键回调
你需要实现ViduCallbackReceiver类,重写onTaskSuccess和onTaskFailed两个方法。
onTaskSuccess中会收到完整结果对象,含task_id、output_text、generated_at(ISO8601时间戳);务必校验generated_at是否在当前时间5分钟内,防止重放攻击。
onTaskFailed回调触发时,error_code为整数,常见值:1001(内容违规)、2003(配额超限)、4001(鉴权失效);【error_code=1001时,不得重试原请求,必须修改prompt后重新提交】。
提交内容审核并获取上线许可
步骤一:在开放平台「内容审核」模块上传待上线的prompt模板集,每条模板需标注使用场景(如“客服话术生成”“营销文案辅助”)。
步骤二:选择审核模式——沙箱模式(即时反馈,不计费,结果不可用于生产)或正式模式(T+1出结果,计入调用配额)。
步骤三:正式审核通过后,平台发放review_pass_id;后续所有调用必须在请求体中携带该字段,否则返回403 Forbidden。










