Gemini 视频生成 API 使用教程(Veo 3 电影级视频,一键接入)

首页 / 文章 / 技术教程 / Gemini 视频生成 API 使用教程(Veo 3 电影级视频,一键接入)

国内开发者如何在Itzyk API(api.itzyk.top)上用一行 curl 调用 Gemini Veo 3 视频生成,从创建 Key 到拿到成片,按秒计费、失败不计费

作者:Itzyk API · 发布:2026-09-22 · 更新:2026-11-16

国内开发者如何在Itzyk API(api.itzyk.top)上用一行 curl 调用 Gemini Veo 3 视频生成,从创建 Key 到拿到成片,按秒计费、失败不计费 标签: Gemini API | 视频生成 | Veo | AI API | 开发教程 | API 聚合平台 更新时间: 2026年9月 阅读时长: 10分钟 --- 一、前言 文字能对话、图片能生成,接下来大家最关心的就是—— 视频 。 Gemini 家族里的视频能力由 Veo 3 承担,特点是电影级镜头语言、物理真实感、甚至能同步生成环境音和对白。但和官方直连一样,国内开发者直接调 Google 会撞上三道老问题: 科学上网不稳定、美元计费对账麻烦、密钥分散难管理 。 Itzyk API(api.itzyk.top)把 veo-3.1-generate-preview 这条「最强视频」模型上架,并提供一个 统一的 OpenAI 风格视频端点 。你只需要一个 API Key、一个 Base URL,就能把 Veo 3 的电影级视频生成拉进自己的项目,而且 人民币结算、支付宝充值、按秒计费、账单精确到每一次请求,出片失败不计费 。 本文就是「Gemini 视频生成 API」的完整使用教程:Veo 3 强在哪、在Itzyk上怎么调、每个参数什么意思、curl / Python / Node.js / Go 怎么写、生成的视频大概要多久、以及实际要花多少钱。 --- 二、Veo 3 视频生成强在哪 veo-3.1-generate-preview 是 Gemini 的 电影级视频生成 模型,相比普通文生视频,它强在四点: - 电影级镜头语言 :支持运镜、景深、光影变化的自然表达,提示词里写「航拍」「推镜头」「环绕」都能被理解 - 物理真实感 :运动轨迹、光影反射、流体/布料等更接近真实物理,不容易出现「穿模」「鬼畜」 - 带声音生成 :可同步生成环境音、对白等声音,不用后期配音 - 1K 分辨率 :满足多数营销与内容创作需求 适合场景:短视频广告、产品宣传、创意内容、剧情短片、社媒短视频素材。 一句话定位 : veo-3.1-generate-preview 就是Itzyk平台上「最强的视频模型」,对应 Gemini 家族的 Veo 3 档位。 --- 三、准备工作:注册与创建 API Key 1. 访问Itzyk用户控制台:https://api.itzyk.top/ 2. 点击右上角「注册账号」,填写手机号、设置密码,验证后完成注册 3. 登录后进入「API 管理」页面,点击「创建 API Key」 4. 填写 Key 名称(如: 视频生成服务 ),保存生成的 API Key 5. 到「充值」页面用支付宝充值,确保余额充足(视频按秒计费,建议先充 50 元测试) 安全提示 :API Key 一旦创建请妥善保管,不要提交到公开代码仓库;如泄露请立即在后台禁用并重建。 --- 四、接口说明 4.1 端点 Itzyk的视频生成走一个独立端点,和文本、图片端点共用同一个 API Key: | 项 | 值 | |----|----| | 方法 | POST | | 端点 | https://api.itzyk.top/v1/video/generations | | 鉴权 | Header Authorization: Bearer sk-xxxxxxxx | | 模型 | veo-3.1-generate-preview | | 计费 | 按秒(¥2.97 / 秒,失败不计费) | 4.2 请求参数 | 参数 | 类型 | 必填 | 默认 | 说明 | |------|------|:---:|------|------| | model | string | 是 | - | 固定填 veo-3.1-generate-preview | | prompt | string | 是 | - | 视频描述,支持镜头语言(航拍/推镜/环绕等) | | duration seconds | int | 否 | 8 | 视频时长(秒),计费按此值 | | aspect ratio | string | 否 | - | 画面比例,如 16:9 / 9:16 / 1:1 | | resolution | string | 否 | - | 分辨率档位,如 1080p | 注意 : model 必须是平台上的「视频类型」模型,填文本或图片模型会返回 400 Model 'xxx' is not a video model ;Key 无权限会返回 403 。 4.3 curl 调用 4.4 响应说明 Itzyk会把上游 Gemini 的任务结果透传给你,并在外层补充计费信息。关键字段: | 字段 | 说明 | |------|------| | model | 你请求的模型 code( veo-3.1-generate-preview ) | | billing unit | 固定为 second (按秒计费) | | billed seconds | 本次实际计费的秒数 | | 视频地址 / 任务信息 | 来自上游 Veo 的生成结果,含视频下载链接(注意链接有时效,请及时转存) | 出片 失败不计费 :上游返回非 2xx 时,Itzyk会记录失败日志并原样透传错误,不扣余额。 --- 五、多语言接入 5.1 Python(requests) 5.2 Node.js(fetch) 5.3 Go --- 六、生成要多久、怎么优化 - 耗时 :视频生成是重计算任务,单条 8 秒视频通常需要 几十秒到数分钟 ,比文本/图片慢得多。客户端超时要放宽(建议 ≥ 10 分钟),并做「提交—轮询—取片」的异步设计,不要阻塞在同步等待里。 - 提示词写法 :把「镜头 + 主体 + 动作 + 光影 + 风格」写全,例如「航拍 / 清晨雪山 / 雪豹跃过岩石 / 金色晨光 / 电影感浅景深」,比一句话描述稳定得多。 - 时长控制 : duration seconds 越大成本越高,先用 8 秒验证创意,满意后再拉长。 - 转存 :上游返回的视频链接有时效,拿到后尽快下载到你的对象存储再对外分发。 --- 七、价格与计费 按量计费,标准售价(以平台价格页实时数据为准): | 项 | 计价方式 | 当前售价 | |----|:-------:|:-------:| | veo-3.1-generate-preview | 按秒 | ¥2.97 / 秒 | 示例:一条 8 秒视频 ≈ 8 × 2.97 ≈ ¥23.76 。 价格说明 :以上为当前售价,可能随上游策略与平台活动变动,实时数据以「价格页」为准; 出片失败不计费 。所有消费可在「使用量」和「账单」页面逐笔核对。 --- 八、常见问题 Q1:返回 400 Model 'xxx' is not a video model ? model 填的不是视频模型。视频只能用 veo-3.1-generate-preview ;文本/图片模型走各自端点。 Q2:返回 403 API key not permitted for this model ? 当前 API Key 没有该模型的访问权限,请到「API 管理」检查 Key 的权限范围,或重建一个全权限 Key。 Q3:请求一直不返回? 视频生成慢属正常。放宽客户端超时,并优先采用「异步提交 + 轮询取片」的架构;同时确认余额是否充足(余额不足会提前拦截)。 Q4:视频链接打不开了? 上游链接有时效,请及时转存到自己的对象存储。 --- 九、小结 在Itzyk(api.itzyk.top)上调用 Gemini 视频生成,只需记住三件事: 1. 一个端点 : POST https://api.itzyk.top/v1/video/generations 2. 一个模型 : veo-3.1-generate-preview (Veo 3 电影级视频) 3. 一套计费 :按秒 ¥2.97,失败不计费,账单可逐笔核对 配合同一个 Key,你还能顺手调文本( /v1/chat/completions )和图片( /v1/images/generations ),把「最强文本 + 旗舰文生图 + 最强视频」全部拉进一个项目。去 https://api.itzyk.top/ 注册一个账号,复制上面的 curl,几秒钟就能拿到你的第一条 Veo 3 视频。 --- 本文为Itzyk API(api.itzyk.top)Gemini 系列教程之一。更多模型与价格见平台「模型列表 / 价格页」,接口详情见开发者控制台「API 文档」。

本文发布于 Itzyk API(AI API 网关,OpenAI 兼容)。更多: 文章中心 · 开发者文档 · API 服务 · 价格。

llms.txt · sitemap · robots · 文章

京ICP备19037501号-3