图片与视频 API

# 先读取 GET /models：替换 model，按所选模型填写 parameters 和必需素材。
curl -X POST "https://www.raohuanai.com/api/v1/generations" \
  -H "Authorization: Bearer jg_live_<key_id>_<secret>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-generation-001" \
  -d '{
    "model": "<GET /models 返回的 id>",
    "input": { "prompt": "柔和自然光下的商品展示" },
    "parameters": {}
  }'

{
  "data": {
    "object": "list",
    "data": [
      {
        "id": "unified:123",
        "object": "model",
        "name": "商品视频生成",
        "type": "video",
        "input": {
          "prompt": { "required": true, "max_bytes": 10000 },
          "images": { "max_count": 3, "required": false, "allowed_mime_types": ["image/jpeg", "image/png"] },
          "videos": { "max_count": 1, "required": false, "allowed_mime_types": ["video/mp4"] }
        },
        "parameters": [
          { "name": "duration", "label": "时长", "type": "select", "required": true, "options": [{ "value": 5 }, { "value": 10 }] },
          { "name": "aspect_ratio", "label": "画面比例", "type": "select", "required": true, "options": [{ "value": "9:16" }, { "value": "16:9" }] }
        ],
        "fixed_parameters": {},
        "pricing": {
          "unit": "credits",
          "rules": [
            { "when": { "duration": 5, "aspect_ratio": "9:16" }, "credits": 20 },
            { "when": { "duration": 5, "aspect_ratio": "16:9" }, "credits": 20 },
            { "when": { "duration": 10, "aspect_ratio": "9:16" }, "credits": 40 },
            { "when": { "duration": 10, "aspect_ratio": "16:9" }, "credits": 40 }
          ]
        }
      }
    ],
    "has_more": false
  },
  "request_id": "req_01J..."
}

{
  "data": {
    "id": "asset_01J...",
    "object": "asset",
    "kind": "image",
    "mime_type": "image/jpeg",
    "size_bytes": 1842031,
    "status": "pending",
    "upload": {
      "method": "PUT",
      "url": "https://cos.example.com/presigned-upload...",
      "headers": {
        "Content-Type": "image/jpeg",
        "Cache-Control": "private, max-age=86400"
      },
      "expires_at": "2026-09-01T14:10:00.000Z"
    }
  },
  "request_id": "req_01J..."
}

{
  "data": {
    "id": "gen_01J...",
    "object": "generation",
    "model": "unified:123",
    "type": "video",
    "status": "queued",
    "progress": 0,
    "credits": 20,
    "output": { "assets": [] },
    "error": null,
    "created_at": "2026-09-01T14:00:00.000Z",
    "updated_at": "2026-09-01T14:00:00.000Z",
    "completed_at": null,
    "idempotent_replay": false
  },
  "request_id": "req_01J..."
}

{
  "data": {
    "id": "gen_01J...",
    "object": "generation",
    "model": "unified:123",
    "type": "video",
    "status": "succeeded",
    "progress": 100,
    "credits": 20,
    "output": {
      "assets": [
        {
          "type": "video",
          "url": "https://cdn.example.com/result.mp4",
          "mime_type": "video/mp4",
          "duration": 5
        }
      ]
    },
    "error": null,
    "created_at": "2026-09-01T14:00:00.000Z",
    "updated_at": "2026-09-01T14:03:12.000Z",
    "completed_at": "2026-09-01T14:03:12.000Z"
  },
  "request_id": "req_01J..."
}

{
  "data": {
    "id": "gen_01J...",
    "object": "generation",
    "model": "<创建任务时使用的 model>",
    "type": "video",
    "status": "failed",
    "progress": 0,
    "credits": 20,
    "output": { "assets": [] },
    "error": {
      "code": "<任务错误码>",
      "message": "本次生成失败，按实际错误码处理"
    },
    "created_at": "2026-09-01T14:00:00.000Z",
    "updated_at": "2026-09-01T14:03:12.000Z",
    "completed_at": "2026-09-01T14:03:12.000Z"
  },
  "request_id": "req_01J..."
}

{
  "id": "evt_01J...",
  "type": "generation.succeeded",
  "created_at": "2026-09-01T14:03:12.000Z",
  "data": {
    "id": "gen_01J...",
    "object": "generation",
    "model": "unified:123",
    "type": "video",
    "status": "succeeded",
    "progress": 100,
    "credits": 20,
    "output": {
      "assets": [
        { "type": "video", "url": "https://cdn.example.com/result.mp4", "mime_type": "video/mp4" }
      ]
    },
    "created_at": "2026-09-01T14:00:00.000Z",
    "completed_at": "2026-09-01T14:03:12.000Z"
  }
}

import crypto from "node:crypto";

function verifyWebhook(rawBody, timestamp, signature, secret) {
  const timestampSeconds = Number(timestamp);
  if (!Number.isInteger(timestampSeconds)) return false;
  if (Math.abs(Date.now() / 1000 - timestampSeconds) > 300) return false;

  const matched = /^v1=([a-f0-9]{64})$/i.exec(signature);
  if (!matched) return false;
  const expected = crypto
    .createHmac("sha256", secret)
    .update(timestamp + "." + rawBody)
    .digest("hex");

  const expectedBytes = Buffer.from(expected, "hex");
  const receivedBytes = Buffer.from(matched[1], "hex");
  return expectedBytes.length === receivedBytes.length
    && crypto.timingSafeEqual(expectedBytes, receivedBytes);
}