Vimmerse Story

Partner Model

Fast Inference

REST API

Model Information

Response Time:~300 sec

Status:Active

Version:

0.0.1

Updated:15 days ago

vimmerse-story

Live Demo

Average runtime: ~300 seconds

Input

Configure model parameters

Output

View generated results

Result

Preview, share or download your results with a single click.

Click to get incredible results!

API Reference

View Full Documentation

Prerequisites

Create an API Key from the Eachlabs Console
Install the required dependencies for your chosen language (e.g., requests for Python)

API Integration Steps

1. Create a Prediction

Send a POST request to create a new prediction. This will return a prediction ID that you'll use to check the result. The request should include your model inputs and API key.

import requests
import time

API_KEY = "YOUR_API_KEY"  # Replace with your API key
HEADERS = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json"
}

def create_prediction():
    response = requests.post(
        "https://api.eachlabs.ai/v1/prediction/",
        headers=HEADERS,
        json={
            "model": "vimmerse-story",
            "version": "0.0.1",
            "input": {
  "scene_count": 1,
  "idea": "your idea here"
},
            "webhook_url": ""
        }
    )
    prediction = response.json()
    
    if prediction["status"] != "success":
        raise Exception(f"Prediction failed: {prediction}")
    
    return prediction["predictionID"]

2. Get Prediction Result

Poll the prediction endpoint with the prediction ID until the result is ready. The API uses long-polling, so you'll need to repeatedly check until you receive a success status.

def get_prediction(prediction_id):
    while True:
        result = requests.get(
            f"https://api.eachlabs.ai/v1/prediction/{prediction_id}",
            headers=HEADERS
        ).json()
        
        if result["status"] == "success":
            return result
        elif result["status"] == "error":
            raise Exception(f"Prediction failed: {result}")
        
        time.sleep(1)  # Wait before polling again

3. Complete Example

Here's a complete example that puts it all together, including error handling and result processing. This shows how to create a prediction and wait for the result in a production environment.

try:
    # Create prediction
    prediction_id = create_prediction()
    print(f"Prediction created: {prediction_id}")
    
    # Get result
    result = get_prediction(prediction_id)
    print(f"Output URL: {result['output']}")
    print(f"Processing time: {result['metrics']['predict_time']}s")
except Exception as e:
    print(f"Error: {e}")

Additional Information

The API uses a two-step process: create prediction and poll for results
Response time: ~300 seconds
Rate limit: 60 requests/minute
Concurrent requests: 10 maximum
Use long-polling to check prediction status until completion

Related AI Models

You can seamlessly integrate advanced AI capabilities into your applications without the hassle of managing complex infrastructure.

Eachlabs | AI Workflows for app builders

Minimax Hailuo V1 | Text to Video

Text transforms into clear, reliable videos using Minimax Hailuo T2V-01, built for stable and consistent video generation.

Kling v1.6 Pro Text to Video

Text inputs smoothly turn into consistent, detailed videos using Kling v1.6 Pro Text to Video, designed for high-quality output.

Luma Ray2 720p

Generate 5s and 9s 720p videos

Minimax Hailuo V2 | Standard | Text to Video

Minimax Hailuo V2 Standard Text to Video is a text-to-video model that turns written prompts into realistic, high-quality video content.