Aleph Video Generation Callbacks
When you submit a task to Generate Aleph Video with the callBackUrlparameter, the system pushes the result to that URL when the task finishes.
Callback Mechanism Overview
Workflow
1.
callBackUrl:{
"model": "runway/gen4-aleph",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"prompt": "Turn the scene into a snowy winter day, keep the cartoon fox and the fence",
"video_url": "https://example.com/input-video.mp4"
}
}2.
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5d2e8b7c41f04a6f9e3b0c7a1d6f2e84"
}
}3.
callBackUrl when the task finishes.Callback Request Format
data.resultJson, a JSON string: JSON.parse(data.resultJson).resultUrls[0].Success Callback
Failure Callback
{
"code": 200,
"msg": "Playground task completed successfully.",
"data": {
"taskId": "5d2e8b7c41f04a6f9e3b0c7a1d6f2e84",
"model": "runway/gen4-aleph",
"state": "success",
"param": "{\"input\":\"{\\\"prompt\\\":\\\"Turn the scene into a snowy winter day, keep the cartoon fox and the fence\\\",\\\"video_url\\\":\\\"https://example.com/input-video.mp4\\\"}\",\"callBackUrl\":\"https://your-domain.com/api/callback\",\"model\":\"runway/gen4-aleph\"}",
"resultJson": "{\"resultUrls\":[\"https://tempfile.aiquickdraw.com/p/xxxxxxxx.mp4\"]}",
"createTime": 1791218957000,
"completeTime": 1791219017000,
"updateTime": 1791219017000
}
}Parameter Description
| Parameter | Type | Description |
|---|---|---|
code | integer | 200 = success, 501 = failed |
msg | string | Status message |
data.taskId | string | Task ID returned when you submitted the task |
data.model | string | Model used for the task (runway/gen4-aleph) |
data.state | string | success or fail |
data.param | string | Parameters submitted when creating the task, as a JSON string |
data.resultJson | string | Result as a JSON string, e.g. {"resultUrls":["https://...mp4"]}. Present on success |
data.failCode | string | Failure code. Present on failure |
data.failMsg | string | Failure reason. Present on failure |
data.costTime | integer | Task duration in seconds |
data.creditsConsumed | number | Credits consumed by the task |
data.createTime / data.completeTime / data.updateTime | integer | Unix timestamps in milliseconds |
Callback Reception Examples
Node.js
Python
PHP
Best Practices
Callback URL Configuration Recommendations
1.
2.
3.
taskId may be delivered more than once.4.
5.
Important Reminders