V·Aivdream API

v1.0 · RESTful

V·Aivdream API 允许开发者通过 HTTP 请求集成 AI 视频生成能力到自己的应用中。所有接口均使用 JSON 格式通信。

Base URL: https://8.210.9.169/api

认证

所有 API 请求需在 Header 中携带 JWT Token：

Authorization: Bearer <your_token>

通过登录接口获取 Token，Token 有效期为 7 天。

POST/auth/login

用户登录，获取 Token

参数	类型	必填	说明
`phone`	string	必填	手机号
`code`	string	必填	验证码

响应示例:

{
  "success": true,
  "data": { "token": "eyJhbG...", "credits": 500 }
}

视频生成

POST/generate/create

创建视频生成任务

参数	类型	必填	说明
`prompt`	string	必填	视频描述提示词
`duration`	string	可选	时长: 15s / 30s / 50s / 60s
`ratio`	string	可选	比例: 16:9 / 9:16 / 1:1
`style`	string	可选	风格: cinematic / anime / realistic / commercial
`motion`	string	可选	运镜: auto / static / pan / zoom / orbit / dolly
`quality`	string	可选	画质: 1080p / 4k

积分消耗: 15s=100 / 30s=200 / 50s=320 / 60s=400 (4K额外+50%)

进度查询

GET/video/progress/:taskId?token=<jwt>

实时查询视频生成进度（SSE 风格轮询，2秒间隔）

注意：因 EventSource 不支持自定义 Header，Token 通过 query string 传递。

// 前端示例
const es = new EventSource('/api/video/progress/task123?token=xxx');
es.onmessage = (e) => {
  const data = JSON.parse(e.data);
  // data.stage: queued / initializing / generating / rendering / complete
  // data.percent: 0-100
};

历史记录

GET/generate/videos

获取当前用户的视频生成历史

DELETE/generate/videos/:id

删除指定视频记录

积分管理

GET/credits/balance

查询积分余额

GET/credits/logs

查询积分明细

GET/credits/stats

查询使用统计

签到

POST/credits/checkin

每日签到，获得 50 积分

错误码

错误码	说明
`AUTH_REQUIRED`	未登录或 Token 过期
`INSUFFICIENT_CREDITS`	积分不足
`INVALID_PARAMS`	参数错误
`RATE_LIMITED`	请求频率超限
`GENERATION_FAILED`	生成失败
`ALREADY_CHECKED_IN`	今日已签到

SDK & 示例

cURL

# 登录
curl -X POST https://8.210.9.169/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"phone":"13900000003","code":"888888"}'

# 生成视频
curl -X POST https://8.210.9.169/api/generate/create \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"制作一段15秒商业广告","duration":"15s","ratio":"16:9"}'

Python

import requests

BASE = "https://8.210.9.169/api"

# 登录
r = requests.post(f"{BASE}/auth/login", json={"phone": "13900000003", "code": "888888"})
token = r.json()["data"]["token"]

# 生成视频
headers = {"Authorization": f"Bearer {token}"}
r = requests.post(f"{BASE}/generate/create", headers=headers, json={
    "prompt": "制作一段15秒商业广告",
    "duration": "15s",
    "ratio": "16:9"
})
print(r.json())

用户偏好设置

获取和更新用户的默认生成参数偏好

GET /api/preferences

获取当前用户的偏好设置

# cURL
curl -H "Authorization: Bearer YOUR_TOKEN" https://8.210.9.169/api/preferences

# Python
r = requests.get(f"{BASE}/preferences", headers=headers)
print(r.json())
# Response: { "success": true, "data": { "defaultDuration": "30", "defaultStyle": "cinematic", ... } }

PUT /api/preferences

更新用户偏好设置

r = requests.put(f"{BASE}/preferences", headers=headers, json={
    "defaultDuration": "30",
    "defaultRatio": "9:16",
    "defaultStyle": "cinematic",
    "defaultMotion": "auto",
    "defaultQuality": "1080p",
    "defaultIndustry": "ecommerce",
    "defaultMode": "text-to-video",
    "autoSaveDraft": true,
    "notificationsEnabled": true,
    "language": "zh"
})

自定义模板

管理用户的自定义提示词模板（最多50个）

GET /api/preferences/templates

获取用户的所有自定义模板

r = requests.get(f"{BASE}/preferences/templates", headers=headers)
print(r.json())
# Response: { "success": true, "data": [{ "id": "tpl_1717...", "title": "...", "prompt": "..." }] }

POST /api/preferences/templates

保存新模板

r = requests.post(f"{BASE}/preferences/templates", headers=headers, json={
    "title": "电商带货模板",
    "prompt": "制作一段15秒TikTok电商带货短视频...",
    "industry": "ecommerce",
    "duration": "15",
    "ratio": "9:16",
    "style": "cinematic",
    "motion": "auto"
})

DELETE /api/preferences/templates/:id

删除指定模板

r = requests.delete(f"{BASE}/preferences/templates/tpl_1717...", headers=headers)

WebSocket 实时进度

视频生成进度实时推送

// 连接 WebSocket
const ws = new WebSocket('wss://8.210.9.169/ws?token=YOUR_JWT_TOKEN');

ws.onmessage = (event) => {
    const data = JSON.parse(event.data);
    console.log(data);
    // Progress: { type: "progress", taskId: "...", stage: "generating", percent: 40 }
    // Complete: { type: "complete", taskId: "...", stage: "complete", percent: 100 }
};

// 进度阶段：
// queued (0%) → initializing (15%) → generating (40%) → rendering (70%) → finalizing (90%) → complete (100%)

V·Aivdream API v1.0 · 科技赋能视觉，让商业表达更出彩
V·Aivdream | 智绘光影，成就商业视觉