List architectures
curl --request GET \
--url https://api.mage.space/v1/architectures \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.mage.space/v1/architectures"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.mage.space/v1/architectures', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"architectures": [
{
"id": "<string>",
"name": "<string>",
"type": "image",
"description": "<string>",
"image_inputs": {
"first_frame": "<string>",
"last_frame": "<string>",
"references": {
"field": "<string>",
"additional_field": "<string>"
}
},
"video_inputs": {
"field": "<string>"
},
"base_config": {},
"options": {},
"options_by_model": {},
"input_schema": {
"properties": {},
"required": [
"<string>"
]
},
"gems": 123,
"generate_url": "<string>"
}
]
}{
"error": {
"code": "unauthorized",
"message": "The API key is invalid or has been revoked."
}
}{
"error": {
"code": "internal_error",
"message": "Something went wrong on our side. Retry, and contact support if it persists."
}
}Endpoints
List architectures
GET /v1/architectures returns every model the Mage API can generate with, each with its input fields, option tokens, defaults, JSON Schema, and gem price.
GET
/
v1
/
architectures
List architectures
curl --request GET \
--url https://api.mage.space/v1/architectures \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.mage.space/v1/architectures"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.mage.space/v1/architectures', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"architectures": [
{
"id": "<string>",
"name": "<string>",
"type": "image",
"description": "<string>",
"image_inputs": {
"first_frame": "<string>",
"last_frame": "<string>",
"references": {
"field": "<string>",
"additional_field": "<string>"
}
},
"video_inputs": {
"field": "<string>"
},
"base_config": {},
"options": {},
"options_by_model": {},
"input_schema": {
"properties": {},
"required": [
"<string>"
]
},
"gems": 123,
"generate_url": "<string>"
}
]
}{
"error": {
"code": "unauthorized",
"message": "The API key is invalid or has been revoked."
}
}{
"error": {
"code": "internal_error",
"message": "Something went wrong on our side. Retry, and contact support if it persists."
}
}The API describing itself: every architecture you can generate with, in one call. Use it to build a model picker, to validate a request before sending it, or to read the field names and tokens of a model at runtime instead of hard-coding them. The list changes without a version bump: architectures appear when they launch and disappear when they are retired.
Each entry carries
image_inputs and video_inputs (the config field each media role writes to, so you can tell an image-to-video model from a text-only one before submitting), options and options_by_model (the tokens each adjustable field accepts, narrowed per variant), input_schema (the request body as JSON Schema, defaults folded in), gems (the price of the default config), and generate_url.Last modified on September 17, 2026

