如何通过 API 使用 Gemini Omni 视频生成

Gemini Omni Flash 是 Google 推出的低成本视频模型，在 Hypereal 上通过简单的 REST API 即可调用。无需订阅，无需专用客户端库，既可以输入文本提示生成 720P 视频，也可以附加 1-3 张参考图做图片引导生成。

核心参数：

• 分辨率：720P
• 时长：6 秒或 10 秒
• 画面比例：16:9（横屏）或 9:16（竖屏）
• 图片输入：可选 image_urls 数组，传入 1-3 个已上传或公网可访问的图片 URL
• 无音频 — 仅生成视频
• 价格：$0.1725 / 条（固定价，按量计费）

新账号有免费额度，可以先试用再充值。

第一步：注册 Hypereal 账号并创建 API Key

访问 hypereal.cloud 注册账号，在 Dashboard 里打开 Manage API Keys 创建 API Key。

保存为环境变量：

export HYPEREAL_API_KEY="ck_..."

第二步：生成第一条视频

向视频生成接口发送 POST 请求，附上提示词和参数：

curl -X POST https://hypereal.cloud/api/v1/videos/generate \
  -H "Authorization: Bearer $HYPEREAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini_omni_flash",
    "prompt": "a white cube rotating on a black background, clean product demo",
    "duration": 6,
    "aspect_ratio": "16:9",
    "resolution": "720P",
    "image_urls": [
      "https://your-cdn.com/product-reference.png"
    ]
  }'

API 返回任务 ID 和轮询地址：

{
  "jobId": "job_abc123",
  "pollUrl": "https://hypereal.cloud/api/v1/jobs/job_abc123"
}

视频生成为异步任务。保存 pollUrl，在下一步中用它获取结果。

第三步：参数说明 — duration、resolution、aspect_ratio

参数	可选值	说明
model	gemini_omni_flash	必填
prompt	任意字符串	描述视频内容
duration	6 或 10	单位：秒；默认 6
resolution	720P	目前唯一支持的分辨率
aspect_ratio	16:9 或 9:16	横屏或竖屏
image_urls	1-3 个图片 URL	可选，用于图片引导视频生成

产品演示、场景、横向镜头选 16:9；移动端优先或社交媒体竖版内容选 9:16。

本地图片需要先上传，拿到 URL 后再放进 image_urls。Gemini Omni Flash 视频接口不支持直接传 base64 图片。

第四步：轮询获取结果

生成通常在 30–90 秒内完成。不断请求任务地址，直到 status 变为 "completed"：

curl https://hypereal.cloud/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer $HYPEREAL_API_KEY"

完成后的响应：

{
  "jobId": "job_abc123",
  "status": "completed",
  "output": {
    "url": "https://cdn.hypereal.cloud/videos/job_abc123.mp4"
  }
}

url 字段包含生成好的 MP4 文件直链，可直接下载或嵌入页面。

Node.js 轮询示例：

const delay = ms => new Promise(r => setTimeout(r, ms));

async function waitForVideo(jobId, apiKey) {
  const pollUrl = `https://hypereal.cloud/api/v1/jobs/${jobId}`;
  while (true) {
    const res = await fetch(pollUrl, {
      headers: { Authorization: `Bearer ${apiKey}` },
    });
    const data = await res.json();
    if (data.status === 'completed') return data.output.url;
    if (data.status === 'failed') throw new Error('Generation failed');
    await delay(5000);
  }
}

价格

模型	单价	时长选项	分辨率
gemini_omni_flash	$0.1725	6 秒或 10 秒	720P

按条计费，不按秒计费。10 秒和 6 秒价格相同。无需月度订阅。

免费额度够用来生成最初几条测试视频。需要更大用量时，在 Dashboard 充值通用额度即可。

什么场景适合用 Gemini Omni Flash

• 短产品或概念演示 — 6 秒片段适合落地页和广告投放
• 快速原型验证 — $0.17/条，反复调整提示词的成本极低
• 竖版社交内容 — 9:16 模式直接适配 Reels 和 Shorts，无需二次裁切
• 批量生成流水线 — 固定单价让自动化工作流的成本预估变得简单

如需更长视频或带音频的内容，可以看 Hypereal 上的 Veo 3.1 系列接口。Gemini Omni Flash 的优势在于：高性价比、批量可用、720P 质量。