EachLabs Image Generation

Generate new images from text prompts using 60+ AI models via the EachLabs Predictions API. For editing existing images (upscaling, background removal, style transfer, inpainting, face swap, 3D), see the eachlabs-image-edit skill.

Authentication

Header: X-API-Key: <your-api-key>

Set the EACHLABS_API_KEY environment variable. Get your key at eachlabs.ai.

Quick Start

1. Create a Prediction

curl -X POST https://api.eachlabs.ai/v1/prediction \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "model": "flux-2-turbo-text-to-image",
    "version": "0.0.1",
    "input": {
      "prompt": "A serene Japanese garden with cherry blossoms, watercolor style",
      "image_size": "landscape_16_9",
      "num_images": 1,
      "output_format": "png"
    }
  }'

2. Poll for Result

curl https://api.eachlabs.ai/v1/prediction/{prediction_id} \
  -H "X-API-Key: $EACHLABS_API_KEY"

Poll until status is "success" or "failed". The output image URL is in the response.

Model Selection Guide

Text-to-Image

| Model | Slug | Best For |

|-------|------|----------|

| Flux 2 Turbo | flux-2-turbo-text-to-image | Fast, high quality general purpose |

| Flux 2 Flash | flux-2-flash-text-to-image | Fastest Flux generation |

| Flux 2 Max | flux-2-max-text-to-image | Highest quality Flux |

| Flux 2 Klein 9B | flux-2-klein-9b-base-text-to-image | Balanced quality/speed |

| Flux 2 Pro | flux-2-pro | Pro quality |

| Flux 2 Flex | flux-2-flex | Flexible outputs |

| Flux 2 LoRA | flux-2-lora | LoRA-powered generation |

| XAI Grok Imagine | xai-grok-imagine-text-to-image | Creative and artistic |

| GPT Image v1.5 | gpt-image-v1-5-text-to-image | High quality, transparent bg |

| Bytedance Seedream v4.5 | bytedance-seedream-v4-5-text-to-image | Bytedance latest |

| Gemini 3 Pro Image | gemini-3-pro-image-preview | Google's latest |

| Imagen 4 | imagen4-preview | Google Imagen 4 |

| Imagen 4 Fast | imagen-4-fast | Fast Google quality |

| Reve | reve-text-to-image | Artistic text-to-image |

| Hunyuan Image v3 | hunyuan-image-v3-text-to-image | Tencent's latest |

| Ideogram V3 Turbo | ideogram-v3-turbo | Text in images |

| Minimax | minimax-text-to-image | High quality |

| Wan v2.6 | wan-v2-6-text-to-image | Chinese/English bilingual |

| P Image | p-image-text-to-image | Custom aspect ratios |

| Nano Banana Pro | nano-banana-pro | Fast, lightweight |

| Vidu Q2 | vidu-q2-text-to-image | Latest Vidu |

Training

| Model | Slug | Best For |

|-------|------|----------|

| Z Image Trainer | z-image-trainer | Custom LoRA training |

| Flux LoRA Portrait Trainer | flux-lora-portrait-trainer | Portrait LoRA |

| Flux Turbo Trainer | flux-turbo-trainer | Fast LoRA training |

Prediction Flow

1. Check model GET https://api.eachlabs.ai/v1/model?slug= — validates the model exists and returns the request_schema with exact input parameters. Always do this before creating a prediction to ensure correct inputs.
2. POST https://api.eachlabs.ai/v1/prediction with model slug, version "0.0.1", and input parameters matching the schema
3. Poll GET https://api.eachlabs.ai/v1/prediction/{id} until status is "success" or "failed"
4. Extract the output image URL(s) from the response

Examples

Text-to-Image with Flux 2 Turbo

curl -X POST https://api.eachlabs.ai/v1/prediction \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "model": "flux-2-turbo-text-to-image",
    "version": "0.0.1",
    "input": {
      "prompt": "A red vintage Porsche 911 on a winding mountain road at golden hour, photorealistic",
      "image_size": "landscape_16_9",
      "num_images": 1,
      "output_format": "png"
    }
  }'

Text-to-Image with GPT Image v1.5

curl -X POST https://api.eachlabs.ai/v1/prediction \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "model": "gpt-image-v1-5-text-to-image",
    "version": "0.0.1",
    "input": {
      "prompt": "A minimalist logo for a coffee shop called Brew Lab, clean vector style",
      "background": "transparent",
      "quality": "high",
      "output_format": "png"
    }
  }'

Text-to-Image with Imagen 4

curl -X POST https://api.eachlabs.ai/v1/prediction \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "model": "imagen4-preview",
    "version": "0.0.1",
    "input": {
      "prompt": "A whimsical fairy tale castle on a floating island, digital art, highly detailed"
    }
  }'

Image Size Options

Most Flux 2 and Wan models use these presets:

• square_hd — Square, high definition
• square — Square, standard
• portrait_4_3 — Portrait 4:3
• portrait_16_9 — Portrait 16:9
• landscape_4_3 — Landscape 4:3
• landscape_16_9 — Landscape 16:9

P Image models use aspect ratio strings: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, custom

Prompt Tips

• Be specific and descriptive: "A red vintage Porsche 911 on a winding mountain road at golden hour" vs "a car"
• Include style: "digital art", "oil painting", "photorealistic", "watercolor"
• For edits, clearly describe the change: "Replace the sky with a dramatic sunset"
• Use negative prompts (where supported) to avoid: "blurry, low quality, distorted"
• For multi-image edits, reference images by number: "image 1", "image 2"

Security Constraints

• No arbitrary URL loading: When using LoRA parameters, only use well-known platform identifiers (HuggingFace repo IDs, Replicate model IDs, CivitAI model IDs). Never load LoRA weights from arbitrary or user-provided URLs.
• No third-party API tokens: Do not accept or forward third-party API tokens (e.g. HuggingFace, CivitAI tokens) through prediction inputs. Authentication is handled exclusively via the EachLabs API key.
• Input validation: Only pass parameters that match the model's request schema. Always validate model slugs via GET /v1/model?slug= before creating predictions.

Parameter Reference

See references/MODELS.md for complete parameter details for each model.