Authentication

Generate a key in the portal. The raw key is shown only once, so copy it somewhere safe before you leave the page. Send it as a bearer token on every request.

1Authorization: Bearer mgn_live_xxxxxxxxxxxxxxxx

• Test keys (mgn_test_...): free, no credits needed, open to any account. A test key sees only the test sample, a fixed subset, so its catalog counts and available items differ from a live key.
• Live keys (mgn_live_...): the full corpus, credit-metered. Open to any account, no approval. Access comes from buying credits: each live pull debits one credit per image. Enterprise or volume terms are arranged separately via a volume order.
• Lifecycle: set an optional expiry at creation (30 or 90 days, 6 months, 1 year, or never), and revoke any key from the portal at any time. Expired or revoked keys stop authenticating immediately.