开发者 · API
3 行 cURL,10 分钟跑通批量任务
REST + Webhook · 10 分钟接入。把流光嵌进你的 ERP / 选品系统 / 上新流程,新品到库自动触发视频任务。
01
Quick Start
在 Studio 套餐内点「+ 签发 Key」,复制 sk_live_…,作为 Bearer Token 调用即可。
内容含 AI 生成 · 已通过合规审核本 API 输出视频属于 AIGC,请遵守平台规范合法使用
创建视频任务cURL
# POST /v1/reels — 创建单条任务
curl https://api.liuguang.ai/v1/reels \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{
"product_images": ["https://cdn/…/01.jpg"],
"style": "girl-next-door",
"voice": "madison",
"ratio": "9:16",
"duration": 30,
"script": "Hey, look how light this is —"
}'
# 返回示例
{
"id": "reel_abc123",
"status": "queued",
"eta_s": 183
}批量提交 100 条 SKUNode SDK
import { Liuguang } from '@liuguang/sdk';
const lg = new Liuguang(process.env.LG_KEY);
// 批量提交 CSV manifest
const job = await lg.batches.create({
style: 'girl-next-door',
ratio: '9:16',
manifest: './skus.csv',
on_done: 'https://shop.co/hooks/reel-ready',
});
console.log('queued', job.count, 'reels');
// SDK 自动重试 + webhook 验签02
Endpoints 概览
完整 OpenAPI 3.1 规范,支持 Postman 一键导入。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/reels | 创建视频生成任务,返回任务 ID 与预计耗时 |
| GET | /v1/reels/{id} | 查询单条任务状态与成片 URL |
| GET | /v1/reels | 列出账户内所有任务,支持状态过滤与分页 |
| POST | /v1/voices/clone | 上传 ≥10s 音频,克隆自定义声线⚠ 需授权 |
| POST | /v1/avatars | 上传授权视频,创建专属 AI avatar 并锁定身份⚠ 需授权 |
| POST | /v1/webhooks | 配置 Webhook,订阅 reel.ready / reel.failed / batch.done 事件 |
| GET | /v1/styles | 列出所有可用风格库及参数说明 |
| GET | /v1/voices | 列出可用声线,支持按语种筛选 |
⚠ 使用声线克隆( /v1/voices/clone)和 AI avatar( /v1/avatars)功能须取得被克隆对象本人书面授权,违规使用后果由调用方承担。
03
Quotas & 限额
所有套餐均包含 API 访问,企业版可自定义配额与 SLA。
FREE · 免费版
10 RPM
Studio Pack 基础配额,适合个人开发者测试与原型验证。
- ✓每分钟 10 次请求
- ✓月 500 次调用
- ✓单视频 $0.52
- ✓社区支持
TEAM · 团队版
30 RPM
适合跨境电商运营团队,满足日常批量上新需求。
- ✓每分钟 30 次请求
- ✓月 10,000 次调用
- ✓单视频 $0.42
- ✓邮件 + 工单支持
- ✓Webhook 签名验证
ENTERPRISE · 企业版
Custom SLA
大规模平台或 SaaS 集成,私有 GPU 池隔离调用。
- ✓配额按需定制
- ✓QPS ≤ 200
- ✓私有 GPU 池
- ✓99.9% SLA 保障
- ✓24/7 专属 Slack 频道
04
SDK 与生态
官方 SDK 覆盖主流语言,社区维护 Go / cURL 版本。
立即开始
领取 API Key →