摘要:AI 视频生成不是普通同步接口,真正能商用的 API 算力平台必须支持任务提交、状态查询、回调通知、点数计费和对象存储转存。本文用 https://api.likeadmin.cn 的开放 API 写一套开发者能看懂的接入流程。
标签:API算力超市、AI视频接口、callback_url、对象存储、Token计费、开放API
先说痛点:客户要的不是模型名,而是结果能回来
很多开发者第一次接 AI 视频接口,会把重点放在"支持哪个模型"。但真正接进业务后,客户最关心的是:
| 问题 | 业务含义 |
|---|---|
| 提交后多久返回? | 页面不能一直卡住 |
| 失败会不会扣费? | 要有失败处理和退款逻辑 |
| 结果存在哪里? | 企业要能归档和二次分发 |
| 能不能回调? | 后台任务完成后要自动通知业务系统 |
所以,AI 视频接口的关键不是一次 HTTP 请求,而是完整任务链路。
基础接口地址
开放 API 基础域名固定使用:
http
https://api.likeadmin.cn/api/v1
鉴权方式:
http
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
在真实项目里,API Key 不要写进前端页面,建议由你自己的服务端转发调用。
第一步:提交视频生成任务
下面是一个文生视频请求示例:
bash
curl -X POST "https://api.likeadmin.cn/api/v1/apps/seedance/create" \
-H "Authorization: Bearer sk_xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-text-2-video",
"ratio": "16:9",
"duration": 5,
"resolution": "720p",
"content": [
{
"type": "text",
"text": "一台无人机穿过未来城市楼宇,电影感,镜头缓慢推进"
}
],
"callback_url": "https://your-domain.com/webhook/ai-video"
}'
成功后通常返回任务信息:
json
{
"task_id": "tsk_20260702_xxxxx",
"status": "pending",
"created_at": 1783000000
}
这说明任务已经进入队列。视频类任务不要设计成同步等待,否则用户页面很容易超时。
第二步:查询任务状态
如果你不想接回调,可以用 task_id 主动轮询:
bash
curl "https://api.likeadmin.cn/api/v1/tasks/tsk_20260702_xxxxx" \
-H "Authorization: Bearer sk_xxx"
完成后可能返回:
json
{
"task_id": "tsk_20260702_xxxxx",
"status": "completed",
"result": {
"output": "https://cdn.likeadmin.cn/video/result.mp4"
},
"usage": {
"points": 100
}
}
前端页面可以根据 pending、running、completed、failed 展示不同状态。
第三步:接收 callback_url 回调
如果传了 callback_url,任务完成后平台会向你的地址 POST JSON。你的服务端可以这样接:
js
app.post("/webhook/ai-video", express.json(), async (req, res) => {
const task = req.body;
if (task.status === "completed") {
await saveVideoResult(task.task_id, task.result);
}
if (task.status === "failed") {
await markTaskFailed(task.task_id, task.error);
}
res.json({ ok: true });
});
回调适合后台系统、SaaS 平台、企业应用,不需要用户一直打开页面等结果。
第四步:把结果转存到自己的 OSS
企业客户经常不希望结果只停留在临时链接里。可以在请求里带 storage:
json
{
"model": "seedance-2-text-2-video",
"ratio": "16:9",
"duration": 5,
"resolution": "720p",
"content": [
{
"type": "text",
"text": "电商产品在极简摄影棚中缓慢旋转"
}
],
"storage": {
"oss": {
"bucket": "your-bucket",
"access_key_id": "LTAI_xxx",
"access_key_secret": "xxx",
"endpoint": "oss-cn-hangzhou.aliyuncs.com",
"public_domain": "https://cdn.your-domain.com",
"path_rule": "aigc/video/{task_id}_{index}.mp4"
}
}
}
转存成功后,业务系统拿到的是自己的 CDN 地址,更适合做素材库、客户后台和二次分发。
转化建议:怎么把接口卖给客户
不要只说"我有视频生成接口",要这样讲:
你不用自己搭模型、队列、计费、回调和存储,直接用
https://api.likeadmin.cn把 AI 视频能力接进你的业务系统。
适合转化的人群包括:
- AI 工具站开发者
- 软件公司和外包团队
- 电商服务商
- 短视频营销团队
- 行业 SaaS 厂商
真正能收费的不是模型名,而是稳定交付结果的能力。