AI Card AnimatorAPI

Turn a card you made on AADDYY into a short 9:16 video for WhatsApp Status and Instagram Stories: an 11-second 1080x1920 MP4 plus a poster image. A gentle camera move, light catching the gold and sparkles drifting around the card, with every name, date and venue kept exactly as on your card. Pass the generationId of a card from an AADDYY card maker, such as the wedding invitation or festival greeting card maker. The look is picked from the design, or choose a preset. Asking again for the same card and look within 30 days returns the same video at no charge.

video generation~15 credits/callv1.0.0

Schema

LLMs

Open Markdown content Open in ChatGPT Open in Claude

Endpoint

endpoint

POST https://backend.aaddyy.com/api/ai/card-animator

Authentication

header

Authorization: Bearer YOUR_API_KEY

Parameters

Required

sourceGenerationIdstringrequired

The generationId returned with a card made by an AADDYY card maker, such as AI Wedding Invitation Card Maker or AI Festival Greeting Card Maker (data.generationId in its response; also listed in GET /api/generations). The card must be in your own library. Image URLs are not accepted.

Example: 6745d2c1f0a1b2c3d4e5f607

Optional

presetstring

Animation look. "auto" picks one from the card (e.g. Festival of lights for a Diwali card). GET /api/ai/card-animator/presets (public) lists them.

Values: autogolden-glowfloral-petalsfestival-of-lightswinter-sparklecrescent-nightholi-colourscelebrationbaby-dreamslove-hearts

Default: auto

musicstring

Background music. Only "none" is available for now.

Values: none

Default: none

formatstring

Output shape: story = 9:16, 1080x1920.

Values: story

Default: story

Example Request

cURL

curl -X POST https://backend.aaddyy.com/api/ai/card-animator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceGenerationId": "6745d2c1f0a1b2c3d4e5f607"
  }'

Request Body

json

{
  "sourceGenerationId": "6745d2c1f0a1b2c3d4e5f607"
}

Example Response

json

{
  "success": true,
  "message": "AI Card Animator completed successfully",
  "timestamp": "2026-11-03T18:43:01.677Z",
  "requestId": "req_qeuqkq545",
  "data": {
    "cost": 0.15,
    "remainingCredits": 9.95,
    "video": {
      "url": "https://example.com/card-animation.mp4",
      "width": 1080,
      "height": 1920,
      "duration": 11,
      "file_size": 4132946,
      "content_type": "video/mp4"
    },
    "poster": {
      "url": "https://example.com/card-animation.jpg",
      "width": 1080,
      "height": 1920,
      "file_size": 312840,
      "content_type": "image/jpeg"
    },
    "preset": "golden-glow",
    "presetLabel": "Golden glow",
    "alternatives": [
      "golden-glow",
      "floral-petals",
      "celebration",
      "love-hearts"
    ],
    "music": "none",
    "format": "story",
    "sourceGenerationId": "6745d2c1f0a1b2c3d4e5f607",
    "warnings": [],
    "deduped": false,
    "generationId": "6745d2c1f0a1b2c3d4e5f6aa"
  }
}

SDK

javascript

import { AADDYY } from 'aaddyy'

const client = new AADDYY()
const result = await client._request('POST', '/api/ai/card-animator', {
  "sourceGenerationId": "6745d2c1f0a1b2c3d4e5f607"
})

Install: npm install aaddyy

Pricing

~15 credits (~$0.15) per request

Rate Limits

10 requests per 1m

Burst: 3

← Back to all endpoints