Veevid — AI 视频生成器

一体化 AI 视频生成工具：文本生成视频（text to video）、图像生成视频（image to video） 和 参考图生成视频（reference-to-video），全部通过 Veevid AI 实现。单个 API 接口，支持 10+ 款前沿视频生成模型，包括 Kling 3.0、Sora 2、Veo 3.1、LTX 2.3、Seedance 1.5 Pro 和 Wan 2.6。

环境配置

1. 获取您的 API Key：访问 veevid.ai/settings/api-keys
2. 将密钥保存至本地：

mkdir -p ~/.config/veevid
echo "YOUR_API_KEY" > ~/.config/veevid/api_key

支持的指令表述

以下语句可触发本技能：

• “生成一段海面日落的视频”
• “将这张图片转为视频”
• “使用 Kling 3.0 制作一段 10 秒的产品广告”
• “为 TikTok 创建一段竖屏视频”
• “生成一段视频需要多少费用？”
• “当前有哪些 AI 视频模型可用？”
• “查看我的余额”

从聊天记录中提取图像（Discord / 群聊场景）

当用户请求 图像生成视频（image-to-video），但消息中未提供图像 URL 时：

1. 调用 message read（channel=discord，limit=10），扫描当前频道最近的 10 条消息。
2. 按 发送者 user id 过滤附件，避免误选他人上传的图像。
3. 收集该发送者最近上传的所有图像附件（content_type 以 image/ 开头），按时间倒序排列（最新在前）。
4. 预览方式：引用原消息：使用 message send 并设置 replyTo 为该图像消息的 message id，实现内联图像预览。此举可让用户直观确认图像是否正确，并附带提示文字如“这是您要使用的图像吗？”。切勿仅显示文件名——类似 IMG_20260203_xyz.jpg 的文件名无实际意义。
5. 标准 I2V（单图输入）：引用最新的一张图像消息，并请用户确认。
6. 多图输入场景（例如 Kling 3.0 的起始帧+结束帧，或 Veo 3.1 的 reference-to-video，支持 1–3 张参考图）：对每张图像消息分别加数字编号引用，并询问用户应选用哪些图像及顺序。
7. 若未找到足够图像，请提示用户补发缺失图像或提供图像 URL。

该机制确保即使 Discord 未将附件直接转发给 Agent，图像生成视频功能仍能无缝运行。适用于 所有模型，不局限于某一款特定模型。

重要：生成前必须始终确认

调用生成 API 前，务必执行以下步骤：

1. 调用 POST /api/quote，传入计划生成任务中与计费相关的参数（详见下方“步骤 1”），接口将返回精确所需积分及当前余额。
2. 向用户明确说明拟使用的模型及 quote 返回的确切费用。
3. 对于图像生成视频：还需确认图像是否正确（展示文件名或 URL）。
4. 等待用户明确确认后，再继续执行后续操作。

若生成 API 返回 402 错误码，请将响应体中的 required 与 balance 字段值原样告知用户。

若余额不足，请推荐更低成本的模型，或提供 veevid.ai/pricing 链接供用户查阅。

步骤 1 — 获取报价（生成前确认精确费用）

/api/quote 仅需传入 与计费相关 的参数：mode、generation_type、duration、video_quality、aspect_ratio，以及各模型特有的选项（例如 model_version、generate_audio）。它 不依赖 prompt、image 或其他内容字段——这些字段不影响积分消耗。

curl -X POST https://veevid.ai/api/quote 
  -H "Authorization: Bearer $(cat ~/.config/veevid/api_key)" 
  -H "Content-Type: application/json" 
  -d '{
    "mode": "veo3",
    "generation_type": "text-to-video",
    "video_quality": "standard"
  }'

响应示例：{"required_credits": 20, "current_balance": 451, "sufficient": true}

若 sufficient 为 false，请先推荐更低成本的模型，再向用户发起确认。

步骤 2 — 生成视频（文本生成视频）

curl -X POST https://veevid.ai/api/generate-video 
  -H "Authorization: Bearer $(cat ~/.config/veevid/api_key)" 
  -H "Content-Type: application/json" 
  -d '{
    "prompt": "一只金毛犬在向日葵花田中奔跑，电影级布光",
    "mode": "veo3",
    "aspect_ratio": "16:9",
    "video_quality": "standard"
  }'

响应可能为以下两种之一：

• 异步情形：{"generation_id": "vg_xxx", "status": "processing", "video_url": null, "image_url": null}
• 同步情形：{"generation_id": "vg_xxx", "status": "completed", "video_url": "https://..."}

若 status 已为 completed 且存在 video_url，则立即返回该 URL 给用户，无需轮询。

生成视频 — 图像生成视频

若用户提供的是 在线图像 URL，可直接传入：

curl -X POST https://veevid.ai/api/generate-video 
  -H "Authorization: Bearer $(cat ~/.config/veevid/api_key)" 
  -H "Content-Type: application/json" 
  -d '{
    "prompt": "为此画面添加轻微动画并加入镜头运动",
    "mode": "veo3",
    "aspect_ratio": "16:9",
    "video_quality": "standard",
    "image": "https://example.com/photo.jpg",
    "generation_type": "image-to-video"
  }'

若用户提供的是 本地文件，此时图像 URL 尚未生成——但积分消耗与图像 URL 无关，因此应先使用计费参数调用 quote，再上传：

# 步骤 1：获取报价（图像 URL 不影响计价）
curl -X POST https://veevid.ai/api/quote 
  -H "Authorization: Bearer $(cat ~/.config/veevid/api_key)" 
  -H "Content-Type: application/json" 
  -d '{"mode": "veo3", "generation_type": "image-to-video", "video_quality": "standard"}'

# 步骤 2：上传（仅在用户确认后执行）
curl -X POST https://veevid.ai/api/storage/upload 
  -H "Authorization: Bearer $(cat ~/.config/veevid/api_key)" 
  -F "file=@/path/to/image.jpg"

# 响应示例：{"url": "https://cdn.veevid.ai/uploads/xxx.jpg", "key": "uploads/xxx.jpg"}

# 步骤 3：使用上传后的 URL 发起生成请求
curl -X POST https://veevid.ai/api/generate-video 
  -H "Authorization: Bearer $(cat ~/.config/veevid/api_key)" 
  -H "Content-Type: application/json" 
  -d '{
    "prompt": "为此画面添加动画",
    "mode": "veo3",
    "video_quality": "standard",
    "image": "https://cdn.veevid.ai/uploads/xxx.jpg",
    "generation_type": "image-to-video"
  }'

步骤 3 — 轮询生成状态

若生成响应仍为 processing，需持续轮询直至 status 变为 completed：

curl -H "Authorization: Bearer $(cat ~/.config/veevid/api_key)" 
  https://veevid.ai/api/video-generation/{generation_id}/status

状态流转：processing → completed 或 failed。典型耗时：60–180 秒。

查询积分余额

curl -H "Authorization: Bearer $(cat ~/.config/veevid/api_key)" 
  https://veevid.ai/api/credits

响应示例：{"success": true, "credits": 451, "balance": 451}

可用模型列表

请根据用户需求选择模型。积分消耗范围取决于视频时长、分辨率和质量——请务必在向用户确认前，调用 /api/quote 获取精确费用。

快速模型选择指南

模型参数说明

各模型支持的参数取值各不相同。完整参数表请参阅 references/api-reference.md。

常用通用参数：

错误码说明

对话示例

简单文本生成视频：

User: "生成一段 4 秒钟的猫咪在沙发上睡觉的视频"
Agent: [调用 /api/quote，参数 mode=veo3，video_quality=standard]
Agent: "注意：Veo 3.1 固定生成 8 秒视频（时长不可调整）。本次费用：20 积分。您当前余额为 311 积分。是否继续？"
User: "是"
Agent: [发起生成] "已完成！这是您的 8 秒视频：[URL]"

图像生成视频：

User: "把这张产品图转成短视频" [附带图像]
Agent: [调用 /api/quote，参数 mode=veo3，generation_type=image-to-video]
Agent: "我将为您上传图像，并使用 Veo 3.1 添加动画效果。费用：20 积分。您当前余额为 200 积分。是否继续？"
User: "可以"
Agent: [上传图像并生成] "已完成！这是您的产品动画视频：[URL]"

预算敏感型用户：

User: "生成视频，但尽量控制成本"
Agent: [调用 /api/quote，参数 mode=grok-imagine，duration=6，video_quality=480p]
Agent: "目前最经济的选择是 Grok Imagine，6 秒 480p 视频仅需 10 积分。您当前余额为 50 积分。是否采用该方案？"

相关链接

• Veevid AI
• 获取 API Key
• 定价与积分说明
• 博客与教程