Models - Mesh API

List all models

Python
Node.js
Go

from meshapi import MeshAPI

client = MeshAPI(base_url="https://api.meshapi.ai", token="rsk_...")

models = client.models.list()
for m in models:
    print(m.id, m.name, "free" if m.is_free else "paid")

const models = await client.models.list();
models.forEach(m => {
  console.log(m.id, m.name, m.is_free ? "free" : "paid");
});

models, err := client.Models.List(ctx, meshapi.ListModelsParams{})
if err != nil {
    log.Fatal(err)
}
for _, m := range models {
    fmt.Printf("%s %s\n", m.ID, m.Name)
}

List free or paid models

Pass free to list(): true returns free models only, false paid models only.

Python
Node.js
Go

free = client.models.list(free=True)
paid = client.models.list(free=False)
for m in free:
    print(m.id)

const free = await client.models.list({ free: true });
const paid = await client.models.list({ free: false });
free.forEach(m => console.log(m.id));

client.models.free() and client.models.paid() are shorthands for the same calls.

freeTrue := true
free, err := client.Models.List(ctx, meshapi.ListModelsParams{Free: &freeTrue})
if err != nil {
    log.Fatal(err)
}

freeFalse := false
paid, err := client.Models.List(ctx, meshapi.ListModelsParams{Free: &freeFalse})
if err != nil {
    log.Fatal(err)
}
fmt.Printf("%d free, %d paid\n", len(free), len(paid))

In the current Python (0.1.11) and Go (v0.1.12) releases, client.models.free() / client.models.paid() and client.Models.Free() / client.Models.Paid() call a path the API does not serve and fail with 404. Use list(free=True) / ListModelsParams{Free: ...} as shown above. The Node.js shorthands work.

Filter by type or provider

list() also takes type (text, embedding, image, audio, video) and provider (a provider slug such as openai or vertex). Filters combine. The API also accepts type=evaluation, though the SDK type hints list only the five values above.

Python
Node.js
Go

image_models = client.models.list(type="image")
openai_text = client.models.list(type="text", provider="openai")

const imageModels = await client.models.list({ type: "image" });
const openaiText = await client.models.list({ type: "text", provider: "openai" });

modelType := "image"
imageModels, err := client.Models.List(ctx, meshapi.ListModelsParams{Type: &modelType})
if err != nil {
    log.Fatal(err)
}
for _, m := range imageModels {
    fmt.Println(m.ID)
}

Search models

search() calls GET /v1/models/search: fuzzy text search (q) plus filters (free, discounted, input_modality, output_modality, brand), sorting (sort, order), and paging (limit, offset). It returns a page with items, total, limit, offset, and brands.

Python
Node.js
Go

from meshapi import ModelSearchParams

page = client.models.search(ModelSearchParams(q="gemini", input_modality=["image"], limit=10))
print(page.total)
for m in page.items:
    print(m.id)

const page = await client.models.search({ q: "gemini", input_modality: ["image"], limit: 10 });
console.log(page.total);
page.items.forEach(m => console.log(m.id));

q := "gemini"
limit := 10
page, err := client.Models.Search(ctx, meshapi.ModelSearchParams{
    Q:             &q,
    InputModality: []string{"image"},
    Limit:         &limit,
})
if err != nil {
    log.Fatal(err)
}
for _, m := range page.Items {
    fmt.Println(m.ID)
}

Get one model

Python
Node.js
Go

m = client.models.get("openai/gpt-4o-mini")
print(m.name, m.context_length)

const m = await client.models.get("openai/gpt-4o-mini");
console.log(m.name, m.context_length);

m, err := client.Models.Get(ctx, "openai/gpt-4o-mini")
if err != nil {
    log.Fatal(err)
}
fmt.Println(m.Name)

Model fields

Field	Description
`id`	Model identifier used in requests (e.g. `openai/gpt-4o-mini`)
`name`	Human-readable name
`is_free`	Whether the model is available on the free tier