Put video generation behind your product

Quickstart

Any signed-in user can create an av_live_ key in Developer Center. The secret is shown once — store it on your server.

1. 1. Set environment variables
   Copy

   export AIUNIVID_BASE_URL=https://aiunivid.com/api/open
   export AIUNIVID_API_KEY=av_live_xxx

2. 2. Quote credits (optional, no charge)
   POST the same body to /v1/videos/generations/quote and read data.credits_to_hold.
3. 3. Create the task
   POST /v1/videos/generations with a required Idempotency-Key. Success is 202 plus a task id. Replaying the same key and body does not charge twice.
4. 4. Poll or receive a webhook
   GET /v1/videos/generations/{id} until status is succeeded or failed — or pass callback_url on create. On success, use result.download_url.

Integrate into your video product

Keep AiuniVid behind your backend. Users talk only to your product; your service owns the API key and task sync.

Authentication and scopes

Rate limits

Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (Unix seconds). Exceeding the limit returns 429 rate_limit_exceeded.

Models and capabilities

{
  "success": true,
  "request_id": "req_xxx",
  "data": {
    "models": [
      {
        "id": "seedance-2.0-text-to-video",
        "name": "Seedance 2.0 Text-to-Video",
        "mode": "text-to-video",
        "tier": "standard",
        "durations": [5, 8, 10],
        "aspect_ratios": ["16:9", "9:16", "1:1"],
        "qualities": ["480p", "720p", "1080p"],
        "capabilities": {
          "text_to_video": true,
          "generate_audio": true,
          "max_images": 0,
          "max_videos": 0,
          "max_audios": 0
        }
      }
    ]
  }
}

Quote a generation

{
  "success": true,
  "request_id": "req_01JQ9X2B6XK9K4VQY2QZ4H6W3R",
  "data": {
    "model": "seedance-2.5-text-to-video",
    "credits_to_hold": 50,
    "currency_note": "credits"
  }
}

Create a generation

Task management

{
  "success": true,
  "request_id": "req_xxx",
  "data": {
    "tasks": [{ "id": "vid_01JQ9X2B6XK9K4VQY2QZ4H6W3R", "status": "succeeded" }],
    "next_cursor": null
  }
}

Upload reference media

{
  "success": true,
  "request_id": "req_xxx",
  "data": {
    "upload_url": "https://aiunivid.com/api/open/v1/uploads/put?key=api-uploads/...&sig=...",
    "public_url": "https://cdn.example.com/api-uploads/user/file.png",
    "expires_at": 1761314644,
    "headers": { "Content-Type": "image/png" },
    "method": "PUT"
  }
}

Credit balance

Billing

The website and API use the same markup for the same user. 1 credit = $0.01.

Webhooks

Pass callback_url on create. AiuniVid POSTs the full task object when the task reaches succeeded, failed, or cancelled.

Node

import { createHmac, timingSafeEqual } from "node:crypto";

export function verifyAiuniVidSignature(header, rawBody, secret) {
  const parts = Object.fromEntries(
    header.split(",").map((item) => item.split("="))
  );
  const age = Math.abs(Date.now() / 1000 - Number(parts.t));
  if (age > 300) throw new Error("Signature timestamp is stale");

  const expected = createHmac("sha256", secret)
    .update(`${parts.t}.${rawBody}`)
    .digest("hex");

  if (
    !timingSafeEqual(Buffer.from(parts.v1, "utf8"), Buffer.from(expected, "utf8"))
  ) {
    throw new Error("Invalid signature");
  }
}

Python

import hmac, hashlib, time

def verify_aiunivid_signature(header: str, raw_body: str, secret: str) -> None:
    parts = dict(item.split("=", 1) for item in header.split(","))
    if abs(time.time() - int(parts["t"])) > 300:
        raise ValueError("Signature timestamp is stale")
    expected = hmac.new(
        secret.encode(),
        f'{parts["t"]}.{raw_body}'.encode(),
        hashlib.sha256,
    ).hexdigest()
    if not hmac.compare_digest(parts["v1"], expected):
        raise ValueError("Invalid signature")

Delivery times out after 10 seconds. Non-2xx responses are retried with exponential backoff (1s, 2s, 4s, 8s, …) for up to 24 hours. Always return 2xx to acknowledge the event.

Advanced compatibility path

The primary path is /v1/videos/generations. If you already integrated BytePlus-style content[] payloads, /v1/contents/generations/tasks (and its quote endpoint) remains available. New integrations should not use this path.