Add the EU AI icon to a clip with Timeline compose overlay

You can burn the EU's "AI" icon into a video with one Sume call: POST /v1/timeline-1.0/compose with operation: "overlay", the icon PNG as image.url and your clip as video.url. It returns one new MP4. The icon comes from the European Commission; using it is optional, and the page says Article 50 duties remain mandatory and the icon alone does not establish compliance.

The icon, per the Commission page

The page was updated September 24, 2026.

The compose call

Per the Timeline compose docs, both URLs must already be this workspace's media.sume.com artifacts, so import the PNG and the clip first with POST /v1/media-imports. image.url must probe as a still. Idempotency-Key is required. The default output is 1080x1920 MP4 at the video layer's frame rate; set output to match the clip if it is a different size.

For overlay, layout.position is top, center or bottom, width_ratio is 0.05-1 of the frame width (default 0.9), and margin_ratio is 0-0.45 of height (default 0.05). The default width is far too large for a badge, so set width_ratio yourself.

curl -X POST https://api.sume.com/v1/timeline-1.0/compose \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: eu-ai-icon-001" \
  -d '{
    "operation": "overlay",
    "image": { "url": "https://media.sume.com/artifacts/artf_demo/ai-icon.png" },
    "video": { "url": "https://media.sume.com/artifacts/artf_demo/spot.mp4" },
    "layout": { "position": "bottom", "width_ratio": 0.15, "margin_ratio": 0.05 },
    "mode": "sync"
  }'

Limits and costs

The public rate is $0.02 flat per job; confirm it in GET /v1/catalog. Output length comes from the video layer, with a 300 s ceiling in the docs. The still stays on screen for the whole clip, which fits the first-exposure rule. If the video has no audio the job warns compose_video_has_no_audio and still renders.

The compose docs do not say how transparent PNG pixels are handled. If you use the 50%-transparency icon variant, render a test and check a still from the result (video-frames) before you scale up. The output is a new MP4, so keep the original and treat the overlaid file as the one you publish.