Get Model

Endpoint

GET https://api.eachlabs.ai/v1/model

The preferred GET /v1/models/{slug} path returns the identical response, including cost. The query-parameter route remains available for backwards compatibility.

Query Parameters

Parameter	Type	Required	Description
`slug`	string	Yes	Model slug identifier (e.g., `flux-1-1-pro`)

Code Examples

curl "https://api.eachlabs.ai/v1/model?slug=flux-1-1-pro" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.eachlabs.ai/v1/model",
    params={"slug": "flux-1-1-pro"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

model = response.json()
print(f"Model: {model['title']}")
print(f"Input schema: {model['request_schema']}")

const response = await fetch(
  "https://api.eachlabs.ai/v1/model?slug=flux-1-1-pro",
  {
    headers: { "Authorization": "Bearer YOUR_API_KEY" },
  }
);
const model = await response.json();
console.log(`Model: ${model.title}`);

Response

{
  "title": "Flux 1.1 Pro",
  "slug": "flux-1-1-pro",
  "version": "1.0",
  "output_type": "string",
  "request_schema": {
    "type": "object",
    "required": ["prompt"],
    "properties": {
      "prompt": {
        "type": "string",
        "minLength": 10,
        "maxLength": 500
      }
    }
  },
  "cost": {
    "currency": "USD",
    "type": "fixed",
    "amount": 0.04,
    "unit": "execution",
    "estimate": "$0.04 per execution",
    "description": "Pricing is an estimate and may change as rates are updated."
  }
}

Response Fields

Field	Type	Description
`title`	string	Human-readable model name
`slug`	string	Unique model identifier
`version`	string	Model version
`output_type`	string	Output type (`string`, `array`, `object`)
`request_schema`	object	JSON Schema defining valid input parameters
`cost`	object \| null	Nullable pricing guidance; `null` means no reliable public estimate is available

Cost Estimate

When cost is non-null, it contains exactly these fields:

Field	Type	Description
`currency`	string	Always `USD`
`type`	string	`fixed` or `usage_based`
`amount`	number \| null	Estimated USD amount for fixed pricing; otherwise `null`
`unit`	string \| null	`execution` for fixed pricing; otherwise `null`
`estimate`	string	Presentation-ready guidance: a fixed amount, a safely recognized usage rate/range or billing driver, or the `Usage-based pricing` fallback
`description`	string	`Pricing is an estimate and may change as rates are updated.`

cost is planning guidance, not the final charge. It may be null when no reliable public estimate is available, and estimates may change with provider rates, promotions, or model configuration. When available, fixed pricing includes an amount; usage-based pricing provides a concise rate, range, billing driver, or Usage-based pricing fallback. Pricing internals are not exposed. Use metrics.cost on the resulting prediction or workflow execution for the settled value.

Error Responses

Status	Body	Description
`400`	`{"error": "slug parameter is required"}`	Missing `slug` parameter
`404`	`{"error": "Failed to fetch model: model not found"}`	Model with this slug doesn’t exist
`500`	`{"error": "Failed to fetch models: internal error"}`	Server error

Overview

Models

Predictions

Billing

Content Safety

Webhooks

OpenAPI Reference

Endpoint

Query Parameters

Code Examples

Response

Response Fields

Cost Estimate

Error Responses

​Endpoint

​Query Parameters

​Code Examples

​Response

​Response Fields

​Cost Estimate

​Error Responses

Endpoint

Query Parameters

Code Examples

Response

Response Fields

Cost Estimate

Error Responses