Motion Poster API

用 API Key 以编程方式生成动态海报：鉴权、按 Key 所属用户扣积分。

1) 创建 API Key

请求鉴权使用 Authorization: Bearer <key> 或 x-api-key: <key>。

2) 上传图片（可选）

start_image 需要是 AI 提供商可访问的公开 URL。

export BASE_URL="https://你的域名"
export API_KEY="sk-..."

curl -X POST "$BASE_URL/api/storage/upload-image" \
  -H "Authorization: Bearer $API_KEY" \
  -F "files=@./poster.png"

3) 生成动态海报视频

curl -X POST "$BASE_URL/api/ai/generate" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mediaType": "video",
    "scene": "image-to-video",
    "provider": "replicate",
    "model": "kwaivgi/kling-v2.6",
    "prompt": "A cinematic slow push-in, subtle parallax, soft lighting",
    "options": {
      "start_image": "https://public-url-to-your-image.png",
      "duration": 5,
      "aspect_ratio": "16:9",
      "generate_audio": false
    }
  }'

成功后返回 data.taskId，用它轮询状态。

4) 查询状态并获取结果

curl -X POST "$BASE_URL/api/ai/query" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskId": "<id from /api/ai/generate>" }'

说明

API 调用会按 API Key 所属用户扣积分。
如果返回 no auth 或 insufficient credits，请登录并充值积分。
建议你在自己系统里保存生成结果的 videoUrl，第三方链接可能过期。

API Keys

在这里创建/复制 API Key，然后就能用上面的 curl 示例调用。

API 密钥

登录后可创建 API Key，并用它来调用生成接口（会按 Key 所属用户扣积分）。

登录并创建 API Key