Pull product stills from a video with the video-frames API

POST /v1/video-frames returns up to 24 durable jpeg or png stills from a Sume-hosted clip at the seconds you list, and it is unbilled. Google Merchant Center lists at least 500 x 500 pixels and no promotional elements or content covering the product, so extract stills from the clean clip, not the captioned cut.

How do I ask for stills?

Send video_url (a media.sume.com clip) and exactly one of at[] or fps. at[] takes 1 to 24 seconds, each at least 0 and below the clip length; format is jpeg (default) or png; max_edge clamps the long edge from 16 to 2160. Submit always returns 202; read the result at GET /v1/video-frames/{id}.

curl -X POST https://api.sume.com/v1/video-frames \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: stills-001" \
  -d '{
    "video_url": "https://media.sume.com/artifacts/artf_demo/product.mp4",
    "at": [0.5, 2, 4],
    "format": "png"
  }'

What comes back?

When resource_status is ready, frames holds t, url, width and height for each still, hosted as durable artf_ images. One instant that fails comes back with a null url and does not fail the job.

How does this line up with Google's page?

The rules below are Google's; the frames columns are from the video frames docs.

What should I check?

Pick times where the product is clear of hands and other objects. Google's page in 2026-09-30 recommends 1500x1500 pixels or above, so check the still's width and height in the result against it.