Model discovery and network demand
These public, rate-limited reads use https://api.sogni.ai and need no API key.
Use them to select generation models, show current network activity, and check
worker release information. For the OpenAI-compatible LLM listing, use
/v1/models. The catalog below also covers
image, video, and audio generation.
#Model catalog
GET /v1/model-catalog supports optional filters:
| Parameter | Values |
|---|---|
mediaType |
image, video, audio, or text |
network |
fast or relaxed |
include |
parameters to include parameter metadata in the list |
curl --fail-with-body 'https://api.sogni.ai/v1/model-catalog?mediaType=image&network=fast'
The success envelope contains data.catalogVersion, updatedAt, count, and
models. Model descriptors include id, name, mediaType, tierId,
availableNetworks, workerCounts, tags, and attribution where available.
Some metadata is nullable. Parameters are omitted from the default list.
GET /v1/model-catalog/:modelId returns data.model, including parameter
metadata, with the snapshot version and update time. URL-encode the model ID.
Unknown models return 404; invalid filters return 400.
The catalog is cached for 30 seconds and supports ETag / If-None-Match.
A 304 has no JSON body; reuse your cached representation. Catalog presence
does not reserve a worker or guarantee a particular request can run immediately.
#Live model supply and demand
GET /v1/model-demand?network=fast returns data.updatedAt, networks, count,
and models. Omit network to request the available network snapshots; the
accepted values are fast and relaxed.
Each model has id, name, mediaType, and networks, whose per-network entry contains:
| Counter | Meaning |
|---|---|
workersReady |
Workers advertising availability for this model. |
workersLoaded |
Workers with this model loaded in memory. |
jobsActive |
Jobs currently rendering. |
jobsQueued |
Jobs waiting for assignment. |
These are a snapshot, not a queue-position or completion-time guarantee.
data.networks lists networks whose live counters were reachable: an omitted
network means unavailable information, not zero demand. Temporary inability
to obtain a usable snapshot can return 503.
Responses are cached for 15 seconds and support ETag / If-None-Match.
Poll no faster than that cache interval, and back off on 429 or 503.
#Worker releases
GET /v1/worker/releases returns data.releases, a catalog keyed by worker
engine. It is public and cached for five minutes. Use the returned catalog and
linked worker release notes
to choose a release instead of hard-coding a latest version.
See worker analytics for historical aggregate activity and project status for a single owner-authenticated generation project.