Modelos

GET /models lista o que sua conta pode chamar. Não exige credencial, o que o torna útil tanto como checagem de conectividade quanto como catálogo.

curl https://api.bayle.ai/models

{
  "object": "list",
  "data": [
    { "id": "some-model-id", "object": "model", "type": "text" }
  ]
}

Identificadores de modelo são opacos

Passe um id de volta ao pé da letra como o campo model de uma requisição de geração. Não faça parse dele, não normalize sua caixa, nem infira capacidade a partir do nome: identificadores mudam, e as partes que parecem significativas não são um contrato. Se precisar saber o que um modelo faz, leia seu type.

Fixar um id específico na sua configuração é aceitável, e geralmente sensato para reprodutibilidade. Só reconfira contra este endpoint quando algo parar de funcionar, em vez de assumir que o id é permanente.

Filtrando por classe

Passe ?type= para restringir a lista.

curl "https://api.bayle.ai/models?type=text"

Valor	Modelos para
text	Chat completions
code	Completions orientadas a código
embedding	Embeddings
image	Geração de imagens
inpaint	Inpainting de imagens
upscale	Upscaling de imagens
video	Geração de vídeo
tts	Texto para fala
asr	Reconhecimento de fala
music	Geração de música
all	Tudo, o mesmo que omitir o parâmetro

Um valor não reconhecido é rejeitado através do envelope de erro padrão.

Note que uma classe de modelo aparecer aqui não significa que a Bayle serve um endpoint para ela. A superfície da API são as oito operações na referência; GET /models reporta quais modelos existem, não o que você pode chamar.

Escolhendo um modelo em código

models = client.models.list()
text_models = [m.id for m in models.data if getattr(m, "type", None) == "text"]

Ou filtre no lado do servidor, o que é mais barato:

import httpx

data = httpx.get("https://api.bayle.ai/models", params={"type": "text"}).json()["data"]