text-to-video
Transfer motion from reference videos to animate still images with smooth, realistic results at an affordable price
Use one of our client libraries to get started quickly.
Transfer motion from reference videos to animate still images with smooth, realistic results at an affordable price. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Send a POST request to start generation. The API returns immediately with a prediction ID for polling.
curl -X POST "https://api.vibedream.ai/api/v1/models/kling-v2.6-std-motion/generate" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $VIBEDREAM_API_KEY" \
-d '{
"image": "https://example.com/your-image.jpg",
"video": "https://example.com/your-video.mp4",
"character_orientation": "image",
"prompt": "A beautiful sunset over mountains with golden light",
"negative_prompt": "blurry, distorted, low quality...",
"keep_original_sound": true
}'The API uses an API Key for authentication.
Get your API key from vibedream.ai/models/api-keys.
export VIBEDREAM_API_KEY="your-api-key"
Generation requests are queued and processed asynchronously. Poll the prediction endpoint until status is completed or failed.
curl -X POST "https://api.vibedream.ai/api/v1/models/kling-v2.6-std-motion/generate" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $VIBEDREAM_API_KEY" \
-d '{
"image": "https://example.com/your-image.jpg",
"video": "https://example.com/your-video.mp4",
"character_orientation": "image",
"prompt": "A beautiful sunset over mountains with golden light",
"negative_prompt": "blurry, distorted, low quality...",
"keep_original_sound": true
}'Response
Returns immediately with a prediction ID. Use id to poll for results.
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "processing",
"statusUrl": "https://api.vibedream.ai/api/v1/predictions/550e8400-e29b-41d4-a716-446655440000",
"estimatedTime": "60-120s",
"costCents": 24,
"createdAt": "2025-01-15T12:00:00.000Z"
}# Replace YOUR_PREDICTION_ID with the id from the submit response curl "https://api.vibedream.ai/api/v1/predictions/YOUR_PREDICTION_ID" \ -H "Authorization: Bearer $VIBEDREAM_API_KEY" # Poll every 1-2s until status is "completed" or "failed"
Completed response
outputs is string[] — an array of direct download URLs hosted on assets.vibedream.ai.
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"modelId": "kling-v2.6-std-motion",
"modelName": "Kling 2.6 Standard Motion Control",
"status": "completed",
"outputs": [
"https://assets.vibedream.ai/outputs/550e8400-e29b-41d4-a716-446655440000/1736942400000-0.mp4"
],
"error": null,
"createdAt": "2025-01-15T12:00:00.000Z",
"completedAt": "2025-01-15T12:00:30.000Z"
}Failed response
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"modelId": "kling-v2.6-std-motion",
"modelName": "Kling 2.6 Standard Motion Control",
"status": "failed",
"outputs": null,
"error": "Your request was flagged by content moderation. Please modify your prompt.",
"createdAt": "2025-01-15T12:00:00.000Z",
"completedAt": "2025-01-15T12:00:05.000Z"
}| Field | Type | Description |
|---|---|---|
| id | string | Unique prediction ID (UUID). |
| modelId | string | ID of the model used for generation. |
| modelName | string | Human-readable model name. |
| status | string | Current status. One of: processing, completed, failed. |
| outputs | string[] | null | Array of output URLs. Each URL is a direct download link to the generated file on assets.vibedream.ai. null when still processing or failed. |
| error | string | null | Error message if the generation failed. null on success. |
| createdAt | string | ISO 8601 timestamp when the request was submitted. |
| completedAt | string | null | ISO 8601 timestamp when generation finished. null while processing. |
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| image | string | Yes | -- | -- | Upload the character image (JPG/PNG, max 10MB, min 300px, aspect ratio 1:2.5 to 2.5:1)Pass a public image URL. Accepted: JPEG, PNG, GIF, WebP. |
| video | string | Yes | -- | -- | Upload the motion reference video (MP4/MOV, max 10MB, min 300px)Pass a public video URL. Accepted: MP4, WebM, MOV. |
| character_orientation | string | Yes | image | image, video | Whether the character orientation matches the image or video |
| prompt | string | No | -- | -- | Optional description to guide the generation |
| negative_prompt | string | No | -- | -- | Describe what you don't want in the output |
| keep_original_sound | boolean | No | true | -- | Whether to retain the original video sound |
{
"image": "https://example.com/your-image.jpg",
"video": "https://example.com/your-video.mp4",
"character_orientation": "image",
"prompt": "A beautiful sunset over mountains with golden light",
"negative_prompt": "blurry, distorted, low quality...",
"keep_original_sound": true
}{
"id": "550e8400-e29b-41d4-a716-446655440000",
"modelId": "kling-v2.6-std-motion",
"modelName": "Kling 2.6 Standard Motion Control",
"status": "completed",
"outputs": [
"https://assets.vibedream.ai/outputs/550e8400-e29b-41d4-a716-446655440000/1736942400000-0.mp4"
],
"error": null,
"createdAt": "2025-01-15T12:00:00.000Z",
"completedAt": "2025-01-15T12:00:30.000Z"
}