Getting your development project started with MARA Cloud is easy. All you need is an API key and a URL.
Generate an API key
To generate an API key, go to the API section of the MARA Cloud portal. When generating API keys, be sure to save them securely as they cannot be viewed again.
Note: Each user can generate and use up to 25 API keys.
Manage your keys
From the MARA Cloud portal, you can:
- Create new API keys (up to 25 per user)
- Edit the name of an existing key for easier identification
- Revoke keys that are compromised or no longer needed
Revoked keys stop working immediately and cannot be restored. Generate a new key if needed.
Set up your environment
We recommend storing your API key as an environment variable rather than hardcoding it in your application.
bash
export MARA_API_KEY="your-mara-api-key"
To make this persistent, add the line above to your `~/.bashrc`, `~/.zshrc`, or equivalent shell config file.Then reference it in your code:
python
import os
api_key = os.environ.get("MARA_API_KEY")API endpoints
Base URL (to be used with the OpenAI client, for example):
https://bczfskny6zqw.poweredby.snova.ai/v1Chat completion endpoint (to be used with a cURL command, for example):
https://bczfskny6zqw.poweredby.snova.ai/v1/chat/completionsNote: Refer to the API Reference section to explore all API endpoints.
Authentication
All API requests require a Bearer token in the Authorization header:
Authorization: Bearer your-mara-api-keyNext steps
Now that you have your API key and endpoints, head over to the Quickstart to make your first request.