POST /unified-video/generate
Create the real video generation task after the customer accepts the setup and quote.
Best for
Teams implementing submission flow, task creation, and success states.
How to call it
bash
curl --request POST \
--url https://api-dev.midsync.ai/unified-video/generate \
--header "Authorization: Bearer <midsync_api_key>" \
--header "Content-Type: application/json" \
--data '{
"model": "seedance-1.5-pro",
"prompt": "A cinematic beach at sunset with gentle waves",
"duration": 8,
"resolution": "720p"
}'What this API is for
Use the same request body that passed quote.
After success, store taskId, providerTaskId, model, and pointsCharged, then wait for your callback as the main completion signal.
Request fields
Required. Selected video model id.
Required. Main generation prompt.
Optional or required depending on model.
Optional or required depending on model.
Optional. For models with quality tiers.
Optional. Use values allowed by the selected model.
Optional. Used by models with multiple modes.
Optional boolean. Only for supported models.
Optional image URLs for image-to-video models.
Optional video reference URLs when supported.
Response fields
Whether task creation succeeded.
Internal task id used for polling status.
Upstream provider task id.
Model id used for generation.
Resolved provider model name.
Final charged points for this create request.
Initial task status, usually submitted.
Estimated processing time if available.
Frontend notes
- Disable the primary action while submitting.
- Show pointsCharged after create succeeds.
- Use callback or webhook as the main completion path. Treat /unified-video/:taskId/status as fallback, manual lookup, or recovery.
Ready to test with your own key?
Create a general API key in Settings, then come back here to copy a request example.