Aleph Video Generation Callbacks
Handle webhook notifications for Runway Alpeh video generation completion
Overview
How Callbacks Work
Workflow Steps
1.
callBackUrl parameter in your video generation request:{
"prompt": "Transform into a dreamy watercolor painting style with soft flowing movements",
"videoUrl": "https://example.com/input-video.mp4",
"callBackUrl": "https://your-app.com/webhook/aleph-callback"
}2.
{
"code": 200,
"msg": "success",
"data": {
"taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
}
}3.
Callback Payload
Success Callback
{
"code": 200,
"msg": "success",
"data": {
"result_video_url": "https://file.com/k/xxxxxxx.mp4",
"result_image_url": "https://file.com/m/xxxxxxxx.png"
},
"taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
}Parameter Description
| Parameter | Type | Required | Description |
|---|---|---|---|
code | integer | Yes | Status code indicating the result |
msg | string | Yes | Human-readable message describing the result |
data.result_video_url | string | Yes | URL to access and download the generated video (valid for 14 days) |
data.result_image_url | string | Yes | URL of a thumbnail image from the generated video |
taskId | string | Yes | The original task ID from your generation request |
Status Code Details
| Status Code | Description |
|---|---|
| 200 | Video generated successfully |
| 400 | Generation failed due to content policy or technical issues |
Error Callback
{
"code": 400,
"msg": "Your prompt was caught by our AI moderator. Please adjust it and try again!",
"data": null,
"taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
}Implementing Callback Endpoints
Node.js/Express
Python/Flask
PHP
Security Best Practices
Testing Callbacks
Local Development
Webhook Testing Tools
Troubleshooting
Related Documentation
Need Help