Models

Get a list of all available image generation models. Use the id from this response as the model_version_id when creating generations.

Endpoint

GET /api/v1/models

Authentication

Requires a valid API key in the Authorization header.

Authorization: Bearer bw_your_api_key_here

Request

No request body required.

Example Request

curl https://betterwaifu.com/api/v1/models \
  -H "Authorization: Bearer bw_your_api_key_here"

Response

Success Response (200)

{
  "models": [
    {
      "id": 814910,
      "name": "v6.5",
      "model_name": "tPonynai3",
      "base_model": "Pony",
      "type": "Checkpoint",
      "filename": "tPonynai3_v65.safetensors",
      "cover_image": "https://example.com/cover.jpg",
      "nsfw": false
    },
    {
      "id": 1496755,
      "name": "V1.1",
      "model_name": "Amanatsu (Illustrious)",
      "base_model": "Illustrious",
      "type": "Checkpoint",
      "filename": "amanatsuIllustrious_v11.safetensors",
      "cover_image": null,
      "nsfw": false
    }
  ],
  "count": 25,
  "loras": [
    {
      "id": 1506035,
      "name": "Pony",
      "model_name": "Add Detail - Slider",
      "base_model": "Pony",
      "type": "LORA",
      "filename": "Add_Details_v1.2.safetensors",
      "cover_image": "https://cdn.betterwaifu.com/app/models/1333749/1506035/cover.webp",
      "nsfw": true
    }
  ]
}

models holds checkpoints (usable as model_version_id); loras holds the LoRAs hosted on the workers, whose ids go inside the loras parameter of Generate. count counts checkpoints.

Response Fields

Field	Type	Description
`models`	array	List of available models
`models[].id`	number	Model version ID (use this as `model_version_id` in generate)
`models[].name`	string	Version name
`models[].model_name`	string	Parent model name
`models[].base_model`	string	Base model architecture (e.g., "Pony", "Illustrious")
`models[].type`	string	Model type (e.g., "Checkpoint")
`models[].filename`	string	Model filename
`models[].cover_image`	string \| null	URL to model cover image
`models[].nsfw`	boolean	Whether the model is marked as NSFW
`count`	number	Total number of models returned

Error Responses

401 Unauthorized

{
  "error": "Invalid or missing API key"
}

Notes

Only models with generation enabled are returned
Models are sorted alphabetically by model name, then by version name
The id field is what you pass as model_version_id when generating images
The response also carries a loras array — the LoRAs hosted on the workers, in the same shape. Pass their ids inside the loras parameter of Generate, never as model_version_id