Veo 技能

Veo 是 Google 推出的面向 AI 智能体（AI agents）的先进 AI 视频生成模型系列，属于 Monet AI 统一 API 平台的一部分。

适用场景

在以下情况下使用该技能：

• 高质量视频生成：创建专业级 1080p HD 视频
  • veo-3-1：支持声音生成的高级 AI 视频模型
  • veo-3-1-fast：超高速视频生成模型
• 参考图像生成视频：利用参考图像引导视频内容与风格
• 多宽高比支持：适配不同平台的视频尺寸（如 YouTube 使用 16:9，TikTok 使用 9:16）
• 音画同步内容：Veo 3.1 内置智能音频生成能力

获取 API 密钥

1. 访问 https://monet.vision 注册账户
2. 登录后，前往 https://monet.vision/skills/keys 创建 API 密钥
3. 在环境变量或代码中配置该 API 密钥

如尚未获得 API 密钥，请联系您的管理员在 monet.vision 申请。

快速入门

创建视频生成任务

curl -X POST https://monet.vision/api/v1/tasks/async 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $MONET_API_KEY" 
  -d '{
    "type": "video",
    "input": {
      "model": "veo-3-1",
      "prompt": "A cat running in the park",
      "duration": 8,
      "aspect_ratio": "16:9"
    },
    "idempotency_key": "unique-key-123"
  }'

⚠️ 重要提示：idempotency_key 为必填项。请使用唯一值（例如 UUID），以防止请求重试时重复创建任务。

响应示例：

{
  "id": "task_abc123",
  "status": "pending",
  "type": "video",
  "created_at": "2026-02-27T10:00:00Z"
}

获取任务状态与结果

任务处理为异步执行，您需轮询任务状态，直至其变为 success 或 failed。推荐轮询间隔：5 秒。

curl https://monet.vision/api/v1/tasks/task_abc123 
  -H "Authorization: Bearer $MONET_API_KEY"

任务完成后的响应示例：

{
  "id": "task_abc123",
  "status": "success",
  "type": "video",
  "outputs": [
    {
      "model": "veo-3-1",
      "status": "success",
      "progress": 100,
      "url": "https://files.monet.vision/..."
    }
  ],
  "created_at": "2026-02-27T10:00:00Z",
  "updated_at": "2026-02-27T10:01:30Z"
}

示例：持续轮询直至任务完成

const TASK_ID = "task_abc123";
const MONET_API_KEY = process.env.MONET_API_KEY;

async function pollTask() {
  while (true) {
    const response = await fetch(
      `https://monet.vision/api/v1/tasks/${TASK_ID}`,
      {
        headers: {
          Authorization: `Bearer ${MONET_API_KEY}`,
        },
      },
    );

    const data = await response.json();
    const status = data.status;

    if (status === "success") {
      console.log("Task completed successfully!");
      console.log(JSON.stringify(data, null, 2));
      break;
    } else if (status === "failed") {
      console.log("Task failed!");
      console.log(JSON.stringify(data, null, 2));
      break;
    } else {
      console.log(`Task status: ${status}, waiting...`);
      await new Promise((resolve) => setTimeout(resolve, 5000));
    }
  }
}

pollTask();

支持的模型

veo-3-1

veo-3-1 — Google Veo 3.1

支持声音生成的高级 AI 视频模型

• 🎯 适用场景：需要高质量音画同步输出的视频生成
• 🎵 音频能力：内置智能音频生成
• ⏱️ 时长：8 秒
• 🖥️ 分辨率：1080p HD

{
  model: "veo-3-1",
  prompt: string,                // 必填
  images?: string[],             // 可选：参考图像 URL 数组
  duration?: number,             // 可选：默认为 8
  aspect_ratio?: "1:1" | "16:9" | "9:16"
}

veo-3-1-fast

veo-3.1-fast — Veo 3.1 Fast

超高速视频生成模型

• 🎯 适用场景：需快速迭代、对生成速度敏感的视频生成场景
• ⚡ 速度：超高速生成
• ⏱️ 时长：8 秒
• 🖥️ 分辨率：1080p HD

{
  model: "veo-3-1-fast",
  prompt: string,                // 必填
  images?: string[],             // 可选：参考图像 URL 数组
  duration?: number,             // 可选：默认为 8
  aspect_ratio?: "1:1" | "16:9" | "9:16"
}

API 参考文档

创建任务（异步）

POST /api/v1/tasks/async — 创建异步任务，立即返回任务 ID。

请求示例：

curl -X POST https://monet.vision/api/v1/tasks/async 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $MONET_API_KEY" 
  -d '{
    "type": "video",
    "input": {
      "model": "veo-3-1",
      "prompt": "A cat running in the park"
    },
    "idempotency_key": "unique-key-123"
  }'

⚠️ 重要提示：idempotency_key 为必填项。请使用唯一值（例如 UUID），以防止请求重试时重复创建任务。

响应示例：

{
  "id": "task_abc123",
  "status": "pending",
  "type": "video",
  "created_at": "2026-02-27T10:00:00Z"
}

创建任务（流式）

POST /api/v1/tasks/sync — 创建支持 SSE 流式响应的任务，等待任务完成并实时推送进度。

请求示例：

curl -X POST https://monet.vision/api/v1/tasks/sync 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $MONET_API_KEY" 
  -N 
  -d '{
    "type": "video",
    "input": {
      "model": "veo-3-1",
      "prompt": "A cat running"
    },
    "idempotency_key": "unique-key-123"
  }'

获取任务详情

GET /api/v1/tasks/{taskId} — 获取指定任务的状态与结果。

请求示例：

curl https://monet.vision/api/v1/tasks/task_abc123 
  -H "Authorization: Bearer $MONET_API_KEY"

响应示例：

{
  "id": "task_abc123",
  "status": "success",
  "type": "video",
  "outputs": [
    {
      "model": "veo-3-1",
      "status": "success",
      "progress": 100,
      "url": "https://files.monet.vision/..."
    }
  ],
  "created_at": "2026-02-27T10:00:00Z",
  "updated_at": "2026-02-27T10:01:30Z"
}

列出任务

GET /api/v1/tasks/list — 分页列出所有任务。

请求示例：

curl "https://monet.vision/api/v1/tasks/list?page=1&pageSize=20" 
  -H "Authorization: Bearer $MONET_API_KEY"

响应示例：

{
  "tasks": [
    {
      "id": "task_abc123",
      "status": "success",
      "type": "video",
      "outputs": [
        {
          "model": "veo-3-1",
          "status": "success",
          "progress": 100,
          "url": "https://files.monet.vision/..."
        }
      ],
      "created_at": "2026-02-27T10:00:00Z",
      "updated_at": "2026-02-27T10:01:30Z"
    }
  ],
  "page": 1,
  "pageSize": 20,
  "total": 100
}

上传文件

POST /api/v1/files — 上传文件并获取可公开访问的在线 URL。

📁 文件存储说明：上传的文件将保留 24 小时，过期后自动删除。

请求示例：

curl -X POST https://monet.vision/api/v1/files 
  -H "Authorization: Bearer $MONET_API_KEY" 
  -F "file=@/path/to/your/image.jpg" 
  -v

响应示例：

{
  "id": "file_xyz789",
  "url": "...",
  "filename": "image.jpg",
  "size": 1048576,
  "content_type": "image/jpeg",
  "created_at": "2026-02-27T10:00:00Z"
}

配置说明

环境变量

export MONET_API_KEY="monet_xxx"

认证方式

所有 API 请求均需通过 Authorization 请求头进行身份验证：

Authorization: Bearer monet_xxx