curl --request POST \
  --url https://api.mage.space/v1/{architecture}/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Editorial portrait in soft daylight, 35mm film look"
}
'

import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.generate('mango', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
});

console.log(request.request_id, request.status);

from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.generate("mango", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
})

print(request["request_id"], request["status"])

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({prompt: 'Editorial portrait in soft daylight, 35mm film look'})
};

fetch('https://api.mage.space/v1/{architecture}/generate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
  "status": "in_progress",
  "architecture": "flux2",
  "model_id": "flux2-dev",
  "created_at": "2026-09-17T14:52:48.000Z",
  "updated_at": "2026-09-17T14:52:49.000Z",
  "billing": {
    "mode": "gems",
    "gems_charged": 40
  },
  "result": null,
  "error": null,
  "status_url": "https://api.mage.space/v1/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/status",
  "cancel_url": "https://api.mage.space/v1/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/cancel"
}

{
  "error": {
    "code": "invalid_config",
    "message": "`resolution` must be one of: 768P, 2K."
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "The API key is invalid or has been revoked."
  }
}

{
  "error": {
    "code": "insufficient_gems",
    "message": "This generation costs 40 gems and the account balance is too low.",
    "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
    "gems_required": 40
  }
}

{
  "error": {
    "code": "content_blocked",
    "message": "The request was blocked by Mage's content policy.",
    "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff"
  }
}

{
  "error": {
    "code": "architecture_not_found",
    "message": "Unknown architecture `fluxx`. List architectures at GET /v1/architectures."
  }
}

{
  "error": {
    "code": "architecture_retired",
    "message": "This architecture has been retired.",
    "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff"
  }
}

{
  "error": {
    "code": "too_many_requests",
    "message": "At most 20 generations may be in flight at once for this account; 20 are running now."
  }
}

{
  "error": {
    "code": "content_blocked",
    "message": "The request was blocked by an external content restriction.",
    "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side. Retry, and contact support if it persists."
  }
}