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) 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
POST
https://api.segmind.com/workflows/v2/6adadefb35b07c1cf71beaa2-v1Parameters
product_nameoptionalstringProduct Name
Default:
"Aurora Cold Brew"briefoptionalstringBrief
Default:
"A smooth, low-acid cold brew coffee in a slim recyclable aluminium can. Launching for summer. Tone: fresh, confident, a little playful."audienceoptionalstringAudience
Default:
"Urban 22-35 year olds who commute and work from cafes"product_photooptionalstring (uri)Product Photo
Default:
"https://images.segmind.com/generations/d09a086f-358d-4041-9ef1-4e5f3720bd74/0e3b0ede1d49fee84f97510a04582d9f.png"aspect_ratiooptionalstringAspect Ratio
Default:
"16:9"resolutionoptionalstringResolution
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