For developers

How to generate personalized video gifts from an API

# 1. Create the gift (free)
curl -X POST https://myvideogift.com/api/v1/gifts \
  -H "Authorization: Bearer mvg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "occasion": "anniversary-video",
    "recipient_name": "Maria",
    "relationship": "my wife",
    "memory": "Twenty-five years since the courthouse wedding in the rain.",
    "feeling_words": ["tender", "grateful"],
    "tier": "signature"
  }'
# → { "gift_id": "b3f1c2a4-...", "status": "reserved", "share_slug": "maria-..." }

# 2. Add photos (free)
curl -X POST https://myvideogift.com/api/v1/gifts/b3f1c2a4-.../photos \
  -H "Authorization: Bearer mvg_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "photos": [ { "url": "https://example.com/wedding.jpg" } ] }'

# 3. Render — the one paid call (debits your prepaid balance)
curl -X POST https://myvideogift.com/api/v1/gifts/b3f1c2a4-.../render \
  -H "Authorization: Bearer mvg_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "consent": true }'
# → { "status": "rendering", "charged_cents": 2500, "poll_after_sec": 60 }

# 4. Poll until delivered, then read film_url + gift_url
curl https://myvideogift.com/api/v1/gifts/b3f1c2a4-... \
  -H "Authorization: Bearer mvg_live_..."

{
  "mcpServers": {
    "myvideogift": {
      "command": "npx",
      "args": ["-y", "myvideogift-mcp"],
      "env": { "MVG_API_KEY": "mvg_live_your_key_here" }
    }
  }
}

Common questions

Is there an API to generate a personalized video gift?

Yes. My Video Gift has a REST API — POST /v1/gifts, add photos, then render — plus an MCP server and no-code connectors. Photos and a short brief go in; a finished personalized video gift with an original song that names the recipient comes out. You need a live key with prepaid credits.

How is this different from a video-generation API like Creatomate or Shotstack?

Those are video-editing primitives: you supply the script, timing, layers and audio, and they render the composition you built. My Video Gift is higher-level — it writes the original song that names the recipient, restores and animates the photos, and returns a finished gift film. You bring a few photos and a short brief, not a timeline.

How do I generate a personalized video gift programmatically?

Make four JSON calls to https://myvideogift.com/api/v1: create the gift (occasion plus recipient), add photo URLs, POST render with consent: true, then poll GET /v1/gifts/{id} until status is delivered-paid to get the film URL. Everything before the render is free.

Can AI agents create video gifts with MCP?

Yes. Run npx myvideogift-mcp and any Model Context Protocol client gets five tools — list_occasions, check_account, create_gift, get_gift, and list_gifts. It's published on npm, the official MCP registry (io.github.CryptoLibertus/myvideogift), and Smithery, so an agent can create and deliver a gift on its own.

How do I automate personalized videos without code?

Use n8n (the n8n-nodes-myvideogift community node), Zapier, Pipedream, Activepieces, Apify, or Make. Trigger on a CRM contact, a spreadsheet birthday, or a new order; the Create Video Gift step makes and renders the film, and a delivered-gift trigger hands you the URL to send.

How much does the video gift API cost?

It's wholesale, pay-per-delivery from prepaid credits: standard $12 or signature $25 per delivered film (signature is the default). Creating, uploading, and polling are free; only a delivered render is charged, and a held or failed render auto-refunds. The consumer flow at myvideogift.com is $49 in the browser with a free preview.

Can I automate employee-appreciation or thank-you videos?

Yes. Built-in business occasion presets include employee-appreciation-video, new-hire-welcome-video, donor-thank-you-video, and real-estate-closing-video. A common recipe watches an HRIS for a work anniversary, then auto-generates and delivers an appreciation film to the employee.

Last updated July 11, 2026 · Written by Adam Kling, founder of My Video Gift. Song and idea suggestions verified July 7, 2026.