Developers

Appearance

Generate Multi-Format Videos ​

Asynchronously generate MP4 videos across multiple formats from a single Animated design. Use this endpoint to produce video creatives at different dimensions in one call — for example, a 16:9 landscape video and a 9:16 vertical Story from the same template.

The API returns immediately and delivers results via a NEW_BANNER_BATCH webhook event to your callback_url when all formats are ready.

INFO

This feature is available from the Pro plan.

Endpoint ​

POST/async/banner-builder/{designId}/generateAPI Reference

Generation Characteristics ​

  • Supported Design Type: Animated
  • Response: Asynchronous
  • Required Parameter: image_file_type: "mp4"
  • Retrieval methods: Webhooks, Polling

Output File Types ​

Supported: MP4

Input Video Customization ​

  • Supported input formats: MP4, WebM, MOV
  • Maximum file size: 100 MB
  • Trim with query parameters on the video URL:
    • ?trim_start=2.5 — start at 2.5 seconds
    • ?trim_end=10 — end at 10 seconds
  • Mute audio with audio_muted: true
json
{
  "video_element_name": {
    "video_url": "https://example.com/video.mp4",
    "audio_muted": false
  }
}

Output Customization — FPS ​

Configure frame rate via the video property:

  • Default: 24 fps
  • Range: 2–30 fps
json
{
  "video": { "fps": 24 }
}

Sample Request ​

Replace {YOUR-API-KEY} and {designId} before running.

bash
curl -X POST \
  -H "x-api-key: {YOUR-API-KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://webhook.mycompany.com/videos",
    "image_file_type": "mp4",
    "video": { "fps": 24 },
    "template_format_names": ["facebook-feed", "instagram-post"],
    "elements": {
      "primary_text": { "payload": "New branding available.", "color": "#FF0000" },
      "video_0": { "video_url": "https://mycompany.com/video.mp4", "audio_muted": false }
    }
  }' \
  https://api.abyssale.com/async/banner-builder/{designId}/generate

Sample Response ​

json
{ "generation_request_id": "df75afa8-5a77-4e03-aeef-6d1b6dd0580a" }