AI 视频接口怎么接?用 api.likeadmin.cn 跑通任务、回调和转存

摘要: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
  }
}

前端页面可以根据 pendingrunningcompletedfailed 展示不同状态。

第三步:接收 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 厂商

真正能收费的不是模型名,而是稳定交付结果的能力。