EachLabs Provider Management

Manage the lifecycle of EachLabs AI providers: discover new models via API and implement them as IMG.LY providers.

Key Advantages Over Other Providers

EachLabs provides a structured API for model discovery:

•Programmatic model listing - No need to scrape documentation
•request_schema - Each model includes JSON Schema for inputs (similar to fal.ai)
•Consistent API patterns - Unified prediction/polling interface across all models

Key Files

•Provider Tracking: specs/providers/eachlabs/providers.md
•Provider Specifications: specs/providers/ (schemas, architecture)
•
Provider Implementations:
- •Image: packages/plugin-ai-image-generation-web/src/eachlabs/
- •Video: packages/plugin-ai-video-generation-web/src/eachlabs/
•
README Documentation:
- •Image: packages/plugin-ai-image-generation-web/README.md
- •Video: packages/plugin-ai-video-generation-web/README.md

EachLabs API Reference

Base URL

code

https://api.eachlabs.ai

Authentication

•API Key via header: X-API-Key: <your-api-key>
•
Discovery endpoints do NOT require authentication:
- •GET /v1/models - List all models
- •GET /v1/model?slug=<slug> - Get model details including request_schema
•
Prediction endpoints require API key:
- •POST /v1/prediction - Create prediction
- •GET /v1/prediction/{id} - Get prediction status

Endpoints

List All Models (No Auth Required)

code

GET /v1/models?limit=500&offset=0&name=<filter>

Response:

json

{
  "models": [
    {
      "title": "Flux 2 Pro",
      "slug": "flux-2-pro",
      "version": "0.0.1",
      "output_type": "image"
    }
  ]
}

Get Model Details (No Auth Required)

code

GET /v1/model?slug=<model-slug>

Response includes request_schema:

json

{
  "title": "Flux 2 Pro",
  "slug": "flux-2-pro",
  "version": "0.0.1",
  "output_type": "image",
  "request_schema": {
    "type": "object",
    "required": ["prompt"],
    "properties": {
      "prompt": {
        "type": "string",
        "default": "",
        "description": "The prompt to generate an image from."
      },
      "image_size": {
        "type": "string",
        "default": "landscape_4_3",
        "enum": ["square_hd", "square", "portrait_4_3", "portrait_16_9", "landscape_4_3", "landscape_16_9"]
      }
    }
  }
}

Create Prediction (Auth Required)

code

POST /v1/prediction
Content-Type: application/json
X-API-Key: <api-key>

{
  "model": "flux-2-pro",
  "version": "0.0.1",
  "input": { ... }
}

Get Prediction Status (Auth Required)

code

GET /v1/prediction/{id}
X-API-Key: <api-key>

Response:

json

{
  "id": "...",
  "status": "success|processing|starting|failed|cancelled",
  "output": { ... },
  "predict_time": 12.5,
  "cost": 0.05
}

Workflow Overview

This skill operates in two phases:

•Discovery (automatic): Fetch models via API and compare against tracked models
•Implementation (user-approved): Create provider files for selected models

Phase 1: Discovery

Run the discovery script to get available models:

bash

node .claude/skills/partner-providers-eachlabs/discover-models.mjs

This outputs a minimal JSON array with slug, title, and output_type for each model. Compare against specs/providers/eachlabs/providers.md to identify new models.

For detailed steps, see DISCOVERY_CHECKLIST.md.

Model Categories

Classify models by output_type:

•image - Image generation (text-to-image, image-to-image)
•video - Video generation (text-to-video, image-to-video)
•audio - Audio generation
•text - Text generation
•array - Multi-output (e.g., multiple images)

Determining Capability from Slug/Schema

Pattern	Capability
`-text-to-video`	text-to-video
`-image-to-video`	image-to-video
`image_url` in required	image-to-image or image-to-video
Only `prompt` required, output=image	text-to-image
Only `prompt` required, output=video	text-to-video

Discovery Output Format

code

## Discovery Results

### New Models Found
| Slug | Name | Type | Capability | Recommendation |
|------|------|------|------------|----------------|
| flux-2-pro | Flux 2 Pro | image | t2i | implement |

### Updated Models
| Slug | Change |
|------|--------|
| ... | ... |

### Summary
- X new models found
- Y recommended for implementation
- Z skipped (older versions, niche use cases)

After presenting results, ask: "Which models would you like me to implement?"

Phase 2: Implementation

Only proceed after user approval. Follow IMPLEMENTATION_CHECKLIST.md to:

•Fetch model details to get request_schema
•Convert request_schema to OpenAPI format (add x-imgly-* extensions)
•Create provider TypeScript file and JSON schema
•Export provider from eachlabs/index.ts
•Add translations to translations.json
•Add to example app (examples/ai/src/eachlabsProviders.ts)
•Update specs/providers/eachlabs/providers.md status to "implemented"
•Update README documentation
•Run build checks: pnpm --filter "@imgly/plugin-ai-*" check:all

Schema Conversion

EachLabs request_schema is JSON Schema format. Convert to OpenAPI with IMG.LY extensions:

Input (EachLabs):

json

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The prompt"
    },
    "image_size": {
      "type": "string",
      "enum": ["square", "landscape_4_3"]
    }
  }
}

Output (OpenAPI with extensions):

json

{
  "openapi": "3.0.0",
  "info": { "title": "EachLabs API", "version": "1.0.0" },
  "components": {
    "schemas": {
      "ModelNameInput": {
        "type": "object",
        "properties": {
          "prompt": {
            "title": "Prompt",
            "type": "string",
            "description": "The prompt",
            "x-imgly-builder": { "component": "TextArea" }
          },
          "image_size": {
            "title": "Format",
            "type": "string",
            "enum": ["square", "landscape_4_3"],
            "x-imgly-enum-labels": {
              "square": "Square",
              "landscape_4_3": "Landscape 4:3"
            },
            "x-imgly-builder": { "component": "Select" }
          }
        },
        "x-fal-order-properties": ["prompt", "image_size"],
        "required": ["prompt"]
      }
    }
  },
  "paths": {}
}

UI Component Mapping

JSON Schema Type	x-imgly-builder component
`string` (long text)	`TextArea`
`string` (enum)	`Select`
`string` (url/image)	Custom via `renderCustomProperty`
`boolean`	`Switch`
`integer`/`number`	`Number`

Status Values

When updating providers.md:

Status	When to Use
`implemented`	Provider code exists and works
`planned`	Will implement (high priority)
`skipped`	Intentionally not implementing (older version, limited use)
`undecided`	Needs discussion

References

Skill Files (this folder)

•discover-models.mjs - Discovery script (run to find new models)
•DISCOVERY_CHECKLIST.md - Step-by-step discovery process
•IMPLEMENTATION_CHECKLIST.md - Step-by-step implementation process

Provider Specifications

•specs/providers/README.md - Overview of provider system
•specs/providers/architecture.md - How providers fit into the plugin system
•specs/providers/patterns/ui-guidelines.md - CRITICAL: Which parameters to expose/hide in UI
•specs/providers/patterns/text-to-image.md - T2I implementation pattern
•specs/providers/patterns/image-to-image.md - I2I implementation pattern
•specs/providers/patterns/text-to-video.md - T2V implementation pattern
•specs/providers/patterns/image-to-video.md - I2V implementation pattern

EachLabs-Specific

•specs/providers/eachlabs/providers.md - Model inventory and status