Veo 技能

Veo 是谷歌专为AI智能体设计的高级AI视频生成模型系列，属于Monet AI统一API平台的一部分。

使用场景

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

• - 高质量视频生成：创建专业级1080p高清视频

• - 参考图转视频：使用参考图像引导视频内容和风格
• 多种宽高比：为不同平台生成视频（YouTube用16:9，TikTok用9:16）
• 视听内容：Veo 3.1包含智能音频生成

获取API密钥

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

如果您没有API密钥，请让您的所有者前往monet.vision申请。

快速开始

创建视频生成任务

bash
curl -X POST https://monet.vision/api/v1/tasks/async \
-H Content-Type: application/json \
-H Authorization: Bearer $MONETAPIKEY \
-d {
type: video,
input: {
model: veo-3-1,
prompt: 一只在公园里奔跑的猫,
duration: 8,
aspect_ratio: 16:9
},
idempotency_key: unique-key-123
}

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

响应：

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

获取任务状态和结果

任务处理是异步的。您需要轮询任务状态，直到变为 success 或 failed。建议轮询间隔：5秒。

bash
curl https://monet.vision/api/v1/tasks/task_abc123 \
-H Authorization: Bearer $MONETAPIKEY

完成时的响应：

json
{
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
}

示例：轮询直到完成

typescript
const TASKID = taskabc123;
const MONETAPIKEY = process.env.MONETAPIKEY;

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

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

if (status === success) {
console.log(任务成功完成！);
console.log(JSON.stringify(data, null, 2));
break;
} else if (status === failed) {
console.log(任务失败！);
console.log(JSON.stringify(data, null, 2));
break;
} else {
console.log(任务状态：${status}，等待中...);
await new Promise((resolve) => setTimeout(resolve, 5000));
}
}
}

pollTask();

支持的模型

veo-3-1

veo-3-1 - Google Veo 3.1

带声音的高级AI视频生成

• - 🎯 使用场景：带音频的高质量视频生成
• 🎵 音频：包含智能音频生成
• ⏱️ 时长：8秒
• 🖥️ 分辨率：1080p高清

typescript
{
model: veo-3-1,
prompt: string, // 必填
images?: string[], // 可选：参考图像
duration?: number, // 可选：8（默认值）
aspect_ratio?: 1:1 | 16:9 | 9:16
}

veo-3-1-fast

veo-3.1-fast - Veo 3.1 快速版

超快速视频生成

• - 🎯 使用场景：快速迭代的视频生成
• ⚡ 速度：超快速生成
• ⏱️ 时长：8秒
• 🖥️ 分辨率：1080p高清

typescript
{
model: veo-3-1-fast,
prompt: string, // 必填
images?: string[], // 可选：参考图像
duration?: number, // 可选：8（默认值）
aspect_ratio?: 1:1 | 16:9 | 9:16
}

API参考

创建任务（异步）

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

请求：

bash
curl -X POST https://monet.vision/api/v1/tasks/async \
-H Content-Type: application/json \
-H Authorization: Bearer $MONETAPIKEY \
-d {
type: video,
input: {
model: veo-3-1,
prompt: 一只在公园里奔跑的猫
},
idempotency_key: unique-key-123
}

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

响应：

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

创建任务（流式）

POST /api/v1/tasks/sync - 使用SSE流式创建任务。等待完成并流式传输进度。

请求：

bash
curl -X POST https://monet.vision/api/v1/tasks/sync \
-H Content-Type: application/json \
-H Authorization: Bearer $MONETAPIKEY \
-N \
-d {
type: video,
input: {
model: veo-3-1,
prompt: 一只奔跑的猫
},
idempotency_key: unique-key-123
}

获取任务

GET /api/v1/tasks/{taskId} - 获取任务状态和结果。

请求：

bash
curl https://monet.vision/api/v1/tasks/task_abc123 \
-H Authorization: Bearer $MONETAPIKEY

响应：

json
{
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 - 分页列出任务。

请求：

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

响应：

json
{
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-