Consistent Character Video Generation
Generate dynamic videos with perfect character consistency.
~673.9s
~$3.9674
1import requests
2import time
3import json
4
5api_key = "YOUR_API_KEY"
6url = "https://api.segmind.com/workflows/68628fe34727e611dfa219b4-v4"
7
8data = {
9 "Character_Image": "https://segmind-inference-inputs.s3.amazonaws.com/e698f341-23a1-465e-8164-16c577dfb4d0-5f184e74-c558-4b92-8696-722761fb3737.jpg",
10 "Scene_1": "Model on lighthouse rocks, hair streaming in gale",
11 "Scene_2": "Model emerging from colored smoke, dramatic pose",
12 "Scene_3": "Model by waterfall, mist creating natural wind effects",
13 "Scene_4": "Model against chain-link fence, rebellious lean"
14}
15
16def poll_for_result(poll_url):
17 """Poll the API until the generation is complete"""
18 while True:
19 response = requests.get(
20 poll_url,
21 headers={'Authorization': f'Bearer {api_key}'}
22 )
23 result = response.json()
24
25 if result['status'] == 'COMPLETED':
26 # Parse the output (it's a JSON string)
27 outputs = json.loads(result['output'])
28 return outputs
29 elif result['status'] == 'FAILED':
30 raise Exception(result.get('error', 'Generation failed'))
31
32 # Wait 7 seconds before polling again
33 time.sleep(7)
34
35# Make the initial request
36response = requests.post(
37 url,
38 json=data,
39 headers={
40 'Authorization': f'Bearer {api_key}',
41 'Content-Type': 'application/json'
42 }
43)
44
45if response.status_code == 200:
46 result = response.json()
47 print('Request queued:', result)
48
49 # Start polling for results
50 outputs = poll_for_result(result['poll_url'])
51 print('Generation complete:', outputs)
52else:
53 print(f"Error: {response.status_code}")
54 print(response.text)
1import requests
2import time
3import json
4
5api_key = "YOUR_API_KEY"
6url = "https://api.segmind.com/workflows/68628fe34727e611dfa219b4-v4"
7
8data = {
9 "Character_Image": "https://segmind-inference-inputs.s3.amazonaws.com/e698f341-23a1-465e-8164-16c577dfb4d0-5f184e74-c558-4b92-8696-722761fb3737.jpg",
10 "Scene_1": "Model on lighthouse rocks, hair streaming in gale",
11 "Scene_2": "Model emerging from colored smoke, dramatic pose",
12 "Scene_3": "Model by waterfall, mist creating natural wind effects",
13 "Scene_4": "Model against chain-link fence, rebellious lean"
14}
15
16def poll_for_result(poll_url):
17 """Poll the API until the generation is complete"""
18 while True:
19 response = requests.get(
20 poll_url,
21 headers={'Authorization': f'Bearer {api_key}'}
22 )
23 result = response.json()
24
25 if result['status'] == 'COMPLETED':
26 # Parse the output (it's a JSON string)
27 outputs = json.loads(result['output'])
28 return outputs
29 elif result['status'] == 'FAILED':
30 raise Exception(result.get('error', 'Generation failed'))
31
32 # Wait 7 seconds before polling again
33 time.sleep(7)
34
35# Make the initial request
36response = requests.post(
37 url,
38 json=data,
39 headers={
40 'Authorization': f'Bearer {api_key}',
41 'Content-Type': 'application/json'
42 }
43)
44
45if response.status_code == 200:
46 result = response.json()
47 print('Request queued:', result)
48
49 # Start polling for results
50 outputs = poll_for_result(result['poll_url'])
51 print('Generation complete:', outputs)
52else:
53 print(f"Error: {response.status_code}")
54 print(response.text)
API Endpoint
POST
https://api.segmind.com/workflows/68628fe34727e611dfa219b4-v4
Parameters
Character_Image
optionalstring (uri)
Character Image
Default:
"https://segmind-inference-inputs.s3.amazonaws.com/e698f341-23a1-465e-8164-16c577dfb4d0-5f184e74-c558-4b92-8696-722761fb3737.jpg"
Scene_1
optionalstring
Scene 1
Default:
"Model on lighthouse rocks, hair streaming in gale"
Scene_2
optionalstring
Scene 2
Default:
"Model emerging from colored smoke, dramatic pose"
Scene_3
optionalstring
Scene 3
Default:
"Model by waterfall, mist creating natural wind effects"
Scene_4
optionalstring
Scene 4
Default:
"Model against chain-link fence, rebellious lean"
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