Brief-to-Ad Studio: 20-Second Product Video Ad Serverless API

Turn a product photo, brief and target audience into a 20-second video ad with native sound and a branded tagline. Built for marketers and brands.

~345.96s
~$2.3328
 1import requests
 2import time
 3import json
 4
 5api_key = "YOUR_API_KEY"
 6url = "https://api.segmind.com/workflows/v2/6adadefb35b07c1cf71beaa2-v1"
 7
 8data = {
 9    "product_name": "Aurora Cold Brew",
10    "brief": "A smooth, low-acid cold brew coffee in a slim recyclable aluminium can. Launching for summer. Tone: fresh, confident, a little playful.",
11    "audience": "Urban 22-35 year olds who commute and work from cafes",
12    "product_photo": "https://images.segmind.com/generations/d09a086f-358d-4041-9ef1-4e5f3720bd74/0e3b0ede1d49fee84f97510a04582d9f.png",
13    "aspect_ratio": "16:9",
14    "resolution": "720p"
15}
16
17def poll_for_result(poll_url):
18    """Poll the API until the generation is complete"""
19    while True:
20        response = requests.get(
21            poll_url,
22            headers={'x-api-key': api_key}
23        )
24        result = response.json()
25
26        if result['status'] == 'COMPLETED':
27            # Parse the output (it's a JSON string)
28            outputs = json.loads(result['output'])
29            return outputs
30        elif result['status'] == 'FAILED':
31            raise Exception(result.get('error', 'Generation failed'))
32
33        # Wait 7 seconds before polling again
34        time.sleep(7)
35
36# Make the initial request
37response = requests.post(
38    url,
39    json=data,
40    headers={
41        'x-api-key': api_key,
42        'Content-Type': 'application/json'
43    }
44)
45
46if response.status_code == 200:
47    result = response.json()
48    print('Request queued:', result)
49
50    # Start polling for results
51    outputs = poll_for_result(result['poll_url'])
52    print('Generation complete:', outputs)
53else:
54    print(f"Error: {response.status_code}")
55    print(response.text)

API Endpoint

POSThttps://api.segmind.com/workflows/v2/6adadefb35b07c1cf71beaa2-v1

Parameters

product_nameoptional
string

Product Name

Default: "Aurora Cold Brew"
briefoptional
string

Brief

Default: "A smooth, low-acid cold brew coffee in a slim recyclable aluminium can. Launching for summer. Tone: fresh, confident, a little playful."
audienceoptional
string

Audience

Default: "Urban 22-35 year olds who commute and work from cafes"
product_photooptional
string (uri)

Product Photo

Default: "https://images.segmind.com/generations/d09a086f-358d-4041-9ef1-4e5f3720bd74/0e3b0ede1d49fee84f97510a04582d9f.png"
aspect_ratiooptional
string

Aspect Ratio

Default: "16:9"
resolutionoptional
string

Resolution

Default: "720p"

Response Format

Returns: Polling-based asynchronous response

Initial request returns a poll_url. Poll every 7 seconds until status is COMPLETED.

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Workflow not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out