API 参考文档

https://veo3o1.com/api

Authorization: Bearer YOUR_API_KEY

POST /generate-video

{
  "generationType": "text_to_video" | "image_to_video",
  "prompt": "您的视频描述",
  "aspectRatio": "auto" | "16:9" | "9:16",
  "imageUrl": "https://...", // 如果 generationType 为 "image_to_video" 则必需
  "imageKey": "r2-key" // 可选，用于已上传的图片
}

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "pending",
    "generationType": "text_to_video",
    "prompt": "您的视频描述",
    "aspectRatio": "16:9",
    "createdAt": "2025-10-16T10:00:00Z"
  }
}

curl -X POST https://veo3o1.com/api/generate-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "generationType": "text_to_video",
    "prompt": "美丽的海上日落，海浪轻轻拍打着海岸",
    "aspectRatio": "16:9"
  }'

GET /video-status/{uuid}

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "completed" | "pending" | "processing" | "failed",
    "videoUrl": "https://...", // 状态为 "completed" 时可用
    "progress": 85, // 处理进度 (0-100)
    "estimatedTime": 120 // 预计剩余秒数
  }
}

POST /upload-video-image

curl -X POST https://veo3o1.com/api/upload-video-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

{
  "code": 0,
  "msg": "上传成功",
  "data": {
    "imageUrl": "https://...",
    "imageKey": "r2-key-123"
  }
}

{
  "code": 1001,
  "msg": "积分不足",
  "data": {
    "required": 2,
    "current": 0
  }
}

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1697472000

import { Veo3o1 } from '@veo3o1/sdk';

const client = new Veo3o1('YOUR_API_KEY');

const video = await client.generateVideo({
  generationType: 'text_to_video',
  prompt: '美丽的海上日落',
  aspectRatio: '16:9'
});

console.log('视频 UUID:', video.uuid);

{
  "event": "video.completed",
  "uuid": "video-uuid-123",
  "videoUrl": "https://...",
  "timestamp": "2025-10-16T10:05:00Z"
}