视频 API 完整调用规范

Authorization: Bearer sk-你的API密钥
Content-Type: application/json
Accept: application/json

curl --request POST 'https://cnapi.vip/v1/videos' \
  --header 'Authorization: Bearer sk-xxxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "SD2.5 720P",
    "prompt": "雨夜城市中的银色跑车，低机位跟拍，霓虹倒影，电影感",
    "duration": 8,
    "size": "16:9"
  }'

{
  "model": "SD2.5 720P",
  "prompt": "日出时的海岸航拍，云层缓慢移动",
  "seconds": "8",
  "size": "16:9"
}

{
  "model": "SD2.5 720P",
  "prompt": "保持人物面部、服装和配色一致，在海边缓慢行走，电影级柔光",
  "duration": 10,
  "size": "16:9",
  "images": [
    "https://cdn.example.com/character-front.jpg",
    "https://cdn.example.com/character-side.jpg"
  ]
}

{
  "model": "SD2.0 720P",
  "prompt": "参考镜头节奏和运镜，但保持主体外观不变",
  "duration": 8,
  "size": "16:9",
  "images": ["https://cdn.example.com/subject.jpg"],
  "metadata": {
    "referenceVideos": [
      "https://cdn.example.com/camera-motion.mp4"
    ]
  }
}

{
  "model": "minimax-h3-768p",
  "prompt": "人物按照参考音频的节奏演唱，口型自然",
  "duration": 10,
  "size": "16:9",
  "images": ["https://cdn.example.com/singer.jpg"],
  "metadata": {
    "referenceAudios": [
      "https://cdn.example.com/voice-reference.mp3"
    ]
  }
}

{
  "model": "SD2.5 720P",
  "prompt": "使用参考图的产品外观、参考视频的镜头节奏和参考音频的声音氛围，制作科技广告",
  "duration": 12,
  "size": "16:9",
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-detail.jpg"
  ],
  "metadata": {
    "referenceVideos": [
      "https://cdn.example.com/motion-reference.mp4"
    ],
    "referenceAudios": [
      "https://cdn.example.com/sound-reference.mp3"
    ]
  }
}

{
  "model": "Seedance-2.5-720p官方版",
  "prompt": "从清晨的空旷广场平滑过渡到夜晚灯光亮起的同一构图",
  "duration": 10,
  "size": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

{
  "model": "veo-3.1-fast",
  "prompt": "保持参考图中的主体，镜头缓慢靠近，背景云层自然移动",
  "duration": 8,
  "size": "1920x1080",
  "images": ["https://cdn.example.com/reference.jpg"],
  "metadata": {
    "negativePrompt": "blur, distortion",
    "generateAudio": true
  }
}

{
  "model": "grok-imagine-video-1.5",
  "prompt": "保持参考图主体，从近景缓慢拉远，电影感",
  "duration": 8,
  "size": "16:9",
  "images": ["https://cdn.example.com/start.jpg"],
  "metadata": {
    "resolution": "720p"
  }
}

{
  "model": "gemini-omni-flash",
  "prompt": "保持参考视频的镜头节奏，将主体替换为参考图中的产品",
  "duration": 6,
  "size": "16:9",
  "images": ["https://cdn.example.com/product.jpg"],
  "video": "https://cdn.example.com/reference.mp4"
}

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "SD2.5 720P",
  "status": "queued",
  "progress": 0,
  "created_at": 1788249600
}

curl 'https://cnapi.vip/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'Authorization: Bearer sk-xxxx'

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "SD2.5 720P",
  "status": "completed",
  "progress": 100,
  "created_at": 1788249600,
  "completed_at": 1788250200
}

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "SD2.5 720P",
  "status": "failed",
  "progress": 100,
  "error": {
    "code": "video_generation_failed",
    "message": "视频生成失败"
  }
}

{
  "model": "SD2.5 720P",
  "prompt": "赛博朋克城市中的无人机航拍",
  "duration": 8,
  "size": "16:9",
  "callback_url": "https://api.customer.example/webhooks/cnapi/video"
}

Content-Type: application/json
User-Agent: NewAPI-Task-Callback/1.0
X-NewAPI-Event: video.completed
X-NewAPI-Delivery: evt_task_xxx_completed
X-NewAPI-Timestamp: 1788250200
X-NewAPI-Signature: sha256=<hex-hmac>

{
  "id": "evt_task_xxxxxxxxxxxxxxxxxxxxxxxx_completed",
  "type": "video.completed",
  "created_at": 1788250200,
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
    "model": "SD2.5 720P",
    "status": "completed",
    "progress": "100%",
    "output_url": "https://cnapi.vip/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxx/content",
    "created_at": 1788249600,
    "completed_at": 1788250200
  }
}

{
  "id": "evt_task_xxxxxxxxxxxxxxxxxxxxxxxx_failed",
  "type": "video.failed",
  "created_at": 1788250200,
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
    "model": "SD2.5 720P",
    "status": "failed",
    "progress": "100%",
    "error": "视频生成失败",
    "created_at": 1788249600,
    "completed_at": 1788250200
  }
}

X-NewAPI-Timestamp + "." + 原始请求体字节

import crypto from "node:crypto";
import express from "express";

const app = express();

// 必须先保留原始请求体，再解析 JSON。
app.use(
  express.json({
    verify: (req, _res, buffer) => {
      req.rawBody = buffer;
    },
  }),
);

app.post("/webhooks/cnapi/video", (req, res) => {
  const timestamp = req.header("X-NewAPI-Timestamp") || "";
  const timestampNumber = Number(timestamp);
  if (
    !Number.isFinite(timestampNumber) ||
    Math.abs(Date.now() / 1000 - timestampNumber) > 300
  ) {
    return res.status(401).send("stale timestamp");
  }
  const received = (req.header("X-NewAPI-Signature") || "").replace(
    /^sha256=/,
    "",
  );
  const secret = process.env.API_KEY; // 完整 sk-xxxx
  const signed = Buffer.concat([
    Buffer.from(`${timestamp}.`, "utf8"),
    req.rawBody,
  ]);
  const expected = crypto
    .createHmac("sha256", secret)
    .update(signed)
    .digest("hex");

  const valid =
    received.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));
  if (!valid) return res.status(401).send("invalid signature");

  // 使用 X-NewAPI-Delivery 或 req.body.id 幂等去重。
  console.log(req.body.type, req.body.data.task_id);
  return res.sendStatus(204);
});

curl --location \
  'https://cnapi.vip/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxx/content' \
  --header 'Authorization: Bearer sk-xxxx' \
  --output result.mp4

const baseUrl = "https://cnapi.vip";
const apiKey = process.env.API_KEY;

const submitResponse = await fetch(`${baseUrl}/v1/videos`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "SD2.5 720P",
    prompt: "保持参考图的产品外观，黑色影棚中缓慢环绕运镜",
    duration: 8,
    size: "16:9",
    images: ["https://cdn.example.com/product.jpg"],
    metadata: {
      referenceVideos: ["https://cdn.example.com/motion.mp4"],
    },
    callback_url: "https://api.customer.example/webhooks/cnapi/video",
  }),
});

if (!submitResponse.ok) {
  throw new Error(`submit failed: ${await submitResponse.text()}`);
}

const task = await submitResponse.json();
const deadline = Date.now() + 30 * 60 * 1000;

while (Date.now() < deadline) {
  await new Promise((resolve) => setTimeout(resolve, 12000));

  const response = await fetch(
    `${baseUrl}/v1/videos/${encodeURIComponent(task.id)}`,
    { headers: { Authorization: `Bearer ${apiKey}` } },
  );
  if (!response.ok) {
    throw new Error(`query failed: ${await response.text()}`);
  }

  const state = await response.json();
  if (state.status === "completed") {
    console.log(
      `${baseUrl}/v1/videos/${encodeURIComponent(task.id)}/content`,
    );
    break;
  }
  if (state.status === "failed") {
    throw new Error(state.error?.message || "video generation failed");
  }
}