Mager API

List models

GET/api/v1/models

Returns every model slug you can send as the model field in POST /api/v1/generation-tasks. Read input_schema to know which input keys, enum values, and required fields a model supports.

Authorization

MagerApiKey
x-mager-api-key<token>

Mager API key

In: header

Header Parameters

x-mager-api-key*string

Mager API key

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/models" \  -H "x-mager-api-key: YOUR_API_KEY"
{  "status": 200,  "message": "Success",  "data": [    {      "model": "image-generator",      "title": "Image Generator",      "subtitle": "Generate commercial images from prompt or presets",      "capability": "IMAGE_GENERATION",      "default_output_count": 1,      "input_schema": {        "type": "object",        "properties": {          "prompt": {            "type": "string",            "description": "Main generation prompt"          },          "aspectRatio": {            "type": "string",            "enum": [              "1:1",              "9:16",              "16:9"            ]          },          "style": {            "type": "string"          }        },        "required": [          "prompt"        ]      },      "model_tiers": [        "lite",        "max"      ]    }  ]}