AI UGC video generator API: one call to a close-camera Format

Yes, an AI UGC video generator can be an API: you send a brief and a product photo, and a finished video comes back on the receipt. With Sume the close-camera look is one catalog Format, sume-close-camera-ugc, called with POST /v1/formats/sume/sume-close-camera-ugc/runs.

The facts below come from the Format catalog, Create a run and Runs and results docs, and from the Format's own published description, read 2026-09-29. The recipe behind the Format is private, so this page does not describe how it works inside.

What does the close-camera UGC Format make?

The Format's description says it creates a finished close-camera UGC video with an intimate handheld selfie composition, direct eye contact, natural creator energy, and a product-led hook. It lists close-up testimonial ads, creator reactions, personal recommendations, and phone-shot social videos as the requests it is for, and says it is not for static campaign deliverables.

Read the description yourself before you call it: GET /v1/formats/sume/sume-close-camera-ugc returns it. The same route returns io and showcase as null for this Format today, so do not build on those two fields.

How do I call it?

Any key that carries formats:write may call a Format by Sume; the run and its spend belong to the calling key. Put the brief in instruction (up to 8000 characters) and the product photo in attachments as an input_image with a public HTTPS image_url. Send an Idempotency-Key on every create, derived from the thing being made.

curl -sS -X POST "https://api.sume.com/v1/formats/sume/sume-close-camera-ugc/runs" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: acme-face-mist-ugc-v1" \
  -d '{
    "instruction": "Vertical 9:16 close-camera UGC ad for the attached hydrating face mist.",
    "attachments": [
      { "type": "input_image", "image_url": "https://example.com/face-mist.png" }
    ],
    "generation_spend_cap_usd": 20
  }'

What comes back, and when?

A fresh run answers 202 with a receipt whose status is queued and whose next_action is poll_status. Follow the URLs on the receipt, or register a communication.webhook_url and take the one terminal webhook. When the run is completed, the receipt carries artifacts[], and its media URLs are durable media.sume.com files that do not expire.

How much does one UGC-style video cost?

There is no fixed price per video. A run is metered at the rates on the API pricing page, plus a 5.5% agent fee by default, and it cannot spend past its cap. generation_spend_cap_usd sets this run's ceiling up to $500; the spend cap post covers every value.

What should I not claim about the result?

For scripts and hooks to feed into instruction, see hook variations for UGC ads; for the wider tool question, see AI UGC ads at scale.

• It is a generated video. Do not present it as a real customer's review or a real person's experience.
• Sume's docs make no promise about sales, engagement or conversion, and neither should your copy.
• Check the product on every frame against the real package before you publish.
• A run that cannot finish comes back failed, not a half-finished completed; check error and output_error first.