Model Aliases

Use stable aliases instead of version-specific model names.

Why Aliases?

Model names like dev2, dev, schnell are version-specific. Aliases provide stable references that automatically point to recommended versions.

Available Aliases

Alias	Current Target	Description
`latest`	`dev2`	Newest FLUX model
`default`	`dev`	Balanced quality/speed
`fast`	`schnell`	Fastest generation
`turbo`	`turbo`	Z-Image fast model

Usage

Using Alias

curl -X POST "https://sync.render.weyl.ai/image/flux/latest/t2i?format=1024" \
  -H "Authorization: Bearer $WEYL_API_KEY" \
  -d '{"prompt": "portrait"}'

Using Specific Version

curl -X POST "https://sync.render.weyl.ai/image/flux/dev2/t2i?format=1024" \
  -H "Authorization: Bearer $WEYL_API_KEY" \
  -d '{"prompt": "portrait"}'

When to Use

Use Aliases When:

Building for long-term stability
Want automatic upgrades to better models
Prototyping / experimentation

Use Specific Versions When:

Need reproducible results
Production systems with change control
Benchmarking

Alias Stability

Aliases are stable references. They may point to different underlying models over time as we release improvements, but:

Output quality will improve or stay the same
API interface remains compatible
Performance will improve or stay the same

Notice: We announce alias updates 7 days in advance.

Query Current Mapping

curl "https://api.render.weyl.ai/models/aliases" \
  -H "Authorization: Bearer $WEYL_API_KEY"

Response:

{
  "aliases": {
    "latest": "dev2",
    "default": "dev",
    "fast": "schnell",
    "turbo": "turbo"
  },
  "updated_at": "2024-01-15T00:00:00Z"
}