POST
/imagine-video8 creditsImagine Video
Generate a short animated video clip from a start frame image and a motion prompt. The image anchors the visual content while the prompt describes how the scene should move or evolve. Returns four video variants to choose from. Use /extend-video to continue the clip after generation.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Required | Text prompt describing the desired video. |
| image_url | string | Required | URL of the start frame / reference image. |
| motion | string | Optional | Amount of motion. "low" for subtle movement, "high" for dynamic motion.Default: lowlowhigh |
| webhook_url | string | Optional | URL where we POST the completed task result. |
| webhook_secret | string | Optional | Sent as x-webhook-secret header in webhook delivery. |
Example Request
cURL
curl -X POST https://api.journeyapi.com/api/v1/imagine-video \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "camera slowly panning across the landscape",
"image_url": "https://example.com/start-frame.jpg",
"motion": "low",
"webhook_url": "https://your-server.com/webhook"
}'Immediate Response
Returns immediately with a task ID. Use /fetch or webhooks to get the result.
200 OK
{
"task_id": "jj4m2i44-m63p-85r8-o150-880099884444"
}Response Fields
| Field | Type | Description |
|---|---|---|
| task_id | string | UUID of the video task. |
| task_type | string | Always "imagine-video". |
| video_urls | string[] | Array of 4 generated video URLs. |
Tips
- 1Video generation takes significantly longer than image generation (1-5 minutes).
- 2Start with "low" motion to get stable results before trying "high".
- 3The image_url serves as the first frame / visual reference.
Quirks & Gotchas
Video generation uses a different underlying model than image generation.
Video quality and consistency varies more than image generation.