Beam Cloud

beam

Deploy and manage AI models in the cloud with Beam Cloud for scalable and fast operations.

Fast Inference

REST API

Try in Console API Docs Examples

Model Information

Response Time~1 sec

StatusActive

Version

0.0.1

Updated2 months ago

Live Demo

Average runtime: ~1 seconds

Input

Configure model parameters

Endpoint Name

Enter endpoint name for a model on Beam Cloud

Enter your endpoint name

Version

Enter an endpoint version for Beam Cloud model

Enter your version

Beam API Secret

Enter Client Secret that you get on Beam dashboard.

Enter your beam api secret

Output

View generated results

Result

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

Click to get incredible results!

Each execution costs $0.00001 With $1 you can run this model about 99999 times.

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": "beam",
            "version": "0.0.1",
            "input": {
  "version": "your version here",
  "endpoint_name": "your endpoint name here",
  "beam_api_key": "your beam api secret here",
  "payload": "your payload here"
}
        }
    )
    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: ~1 seconds
Rate limit: 60 requests/minute
Concurrent requests: 10 maximum
Use long-polling to check prediction status until completion

Related AI Models

Skyvern Automations

skyvern

Integration