Create Model Prediction

curl --request POST \
  --url https://api.eachlabs.ai/v1/prediction \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "flux-1-1-pro",
  "input": {
    "prompt": "A beautiful sunset over the ocean with vibrant colors",
    "aspect_ratio": "16:9"
  },
  "webhook_url": "https://your-app.com/webhook",
  "webhook_secret": "your-secret-key"
}
'

import requests

url = "https://api.eachlabs.ai/v1/prediction"

payload = {
    "model": "flux-1-1-pro",
    "input": {
        "prompt": "A beautiful sunset over the ocean with vibrant colors",
        "aspect_ratio": "16:9"
    },
    "webhook_url": "https://your-app.com/webhook",
    "webhook_secret": "your-secret-key"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'flux-1-1-pro',
    input: {
      prompt: 'A beautiful sunset over the ocean with vibrant colors',
      aspect_ratio: '16:9'
    },
    webhook_url: 'https://your-app.com/webhook',
    webhook_secret: 'your-secret-key'
  })
};

fetch('https://api.eachlabs.ai/v1/prediction', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.eachlabs.ai/v1/prediction",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'flux-1-1-pro',
    'input' => [
        'prompt' => 'A beautiful sunset over the ocean with vibrant colors',
        'aspect_ratio' => '16:9'
    ],
    'webhook_url' => 'https://your-app.com/webhook',
    'webhook_secret' => 'your-secret-key'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.eachlabs.ai/v1/prediction"

	payload := strings.NewReader("{\n  \"model\": \"flux-1-1-pro\",\n  \"input\": {\n    \"prompt\": \"A beautiful sunset over the ocean with vibrant colors\",\n    \"aspect_ratio\": \"16:9\"\n  },\n  \"webhook_url\": \"https://your-app.com/webhook\",\n  \"webhook_secret\": \"your-secret-key\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.eachlabs.ai/v1/prediction")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"flux-1-1-pro\",\n  \"input\": {\n    \"prompt\": \"A beautiful sunset over the ocean with vibrant colors\",\n    \"aspect_ratio\": \"16:9\"\n  },\n  \"webhook_url\": \"https://your-app.com/webhook\",\n  \"webhook_secret\": \"your-secret-key\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.eachlabs.ai/v1/prediction")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"flux-1-1-pro\",\n  \"input\": {\n    \"prompt\": \"A beautiful sunset over the ocean with vibrant colors\",\n    \"aspect_ratio\": \"16:9\"\n  },\n  \"webhook_url\": \"https://your-app.com/webhook\",\n  \"webhook_secret\": \"your-secret-key\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "message": "Prediction created successfully",
  "predictionID": "abc123-def456-ghi789"
}

{
  "error": "slug parameter is required"
}

{
  "error": "Failed to fetch models: internal error"
}

Create Model Prediction

Create a new prediction for a specific model.

Using a configured model fallback

Saving or enabling a model fallback does not automatically apply it to prediction requests. To opt a prediction into an enabled fallback configuration, include fallback_selector at the top level of the request body, alongside model and input (not inside input). Its value is the saved fallback configuration’s slug, not the fallback model’s slug or ID. The configuration must belong to the API key’s organization and the requested primary model.

For example, if you have saved an enabled configuration with the slug quality-recovery for flux-1-1-pro, send:

{
  "model": "flux-1-1-pro",
  "fallback_selector": "quality-recovery",
  "input": {
    "prompt": "A beautiful sunset over the ocean",
    "aspect_ratio": "16:9"
  }
}

Replace quality-recovery with your saved configuration’s slug, and keep model and input set for the primary model. The saved configuration supplies the fallback models and input mappings. Omit fallback_selector to run only the primary model, even when a fallback configuration exists.

POST

prediction

Create Model Prediction

curl --request POST \
  --url https://api.eachlabs.ai/v1/prediction \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "flux-1-1-pro",
  "input": {
    "prompt": "A beautiful sunset over the ocean with vibrant colors",
    "aspect_ratio": "16:9"
  },
  "webhook_url": "https://your-app.com/webhook",
  "webhook_secret": "your-secret-key"
}
'

import requests

url = "https://api.eachlabs.ai/v1/prediction"

payload = {
    "model": "flux-1-1-pro",
    "input": {
        "prompt": "A beautiful sunset over the ocean with vibrant colors",
        "aspect_ratio": "16:9"
    },
    "webhook_url": "https://your-app.com/webhook",
    "webhook_secret": "your-secret-key"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'flux-1-1-pro',
    input: {
      prompt: 'A beautiful sunset over the ocean with vibrant colors',
      aspect_ratio: '16:9'
    },
    webhook_url: 'https://your-app.com/webhook',
    webhook_secret: 'your-secret-key'
  })
};

fetch('https://api.eachlabs.ai/v1/prediction', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.eachlabs.ai/v1/prediction",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'flux-1-1-pro',
    'input' => [
        'prompt' => 'A beautiful sunset over the ocean with vibrant colors',
        'aspect_ratio' => '16:9'
    ],
    'webhook_url' => 'https://your-app.com/webhook',
    'webhook_secret' => 'your-secret-key'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.eachlabs.ai/v1/prediction"

	payload := strings.NewReader("{\n  \"model\": \"flux-1-1-pro\",\n  \"input\": {\n    \"prompt\": \"A beautiful sunset over the ocean with vibrant colors\",\n    \"aspect_ratio\": \"16:9\"\n  },\n  \"webhook_url\": \"https://your-app.com/webhook\",\n  \"webhook_secret\": \"your-secret-key\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.eachlabs.ai/v1/prediction")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"flux-1-1-pro\",\n  \"input\": {\n    \"prompt\": \"A beautiful sunset over the ocean with vibrant colors\",\n    \"aspect_ratio\": \"16:9\"\n  },\n  \"webhook_url\": \"https://your-app.com/webhook\",\n  \"webhook_secret\": \"your-secret-key\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.eachlabs.ai/v1/prediction")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"flux-1-1-pro\",\n  \"input\": {\n    \"prompt\": \"A beautiful sunset over the ocean with vibrant colors\",\n    \"aspect_ratio\": \"16:9\"\n  },\n  \"webhook_url\": \"https://your-app.com/webhook\",\n  \"webhook_secret\": \"your-secret-key\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "message": "Prediction created successfully",
  "predictionID": "abc123-def456-ghi789"
}

{
  "error": "slug parameter is required"
}

{
  "error": "Failed to fetch models: internal error"
}

Authorizations

Authorization

string

header

required

API key passed as Authorization: Bearer <api_key>

Body

application/json

model

string

required

Model slug or identifier

Example:

"flux-1-1-pro"

input

object

required

Input parameters for the prediction

Example:

{
  "prompt": "A beautiful sunset over the ocean with vibrant colors",
  "aspect_ratio": "16:9"
}

fallback_selector

string

Optional opt-in to an enabled, saved fallback configuration for this organization and primary model. Use the configuration's slug, not a fallback model slug or ID. Set this at the top level of the request, not inside input. Saving a configuration alone does not enable fallback for a request: omitting this field runs only the primary model. Use 1-50 lowercase letters and digits separated by single hyphens.

Required string length: 1 - 50

Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Example:

"quality-recovery"

version

string

deprecated

Deprecated. This field is ignored. Kept for backwards compatibility.

Example:

"0.0.1"

webhook_url

string<uri>

Optional webhook URL to receive prediction result asynchronously

Example:

"https://your-app.com/webhook"

webhook_secret

string

Optional secret used to sign webhook requests

Example:

"your-secret-key"

Response

Prediction created successfully

status

string

Status of the prediction creation request

Example:

"success"

message

string

Human-readable message about the prediction creation

Example:

"Prediction created successfully"

predictionID

string

Unique prediction identifier

Example:

"abc123-def456-ghi789"

Last modified on September 30, 2026

Overview

Models

Predictions

Billing

Content Safety

Webhooks

OpenAPI Reference

Create Model Prediction

Using a configured model fallback

Authorizations

Body

Response