Authentication

The CompactifAI API uses API keys for authentication. This guide will walk you through the process of obtaining and using your API key.

How to Get Started

The CompactifAI API is currently available exclusively through the AWS Marketplace. Follow these steps to get started:

1. Subscribe via AWS Marketplace

1. Go to our AWS Marketplace listing.
2. Review the product details, pricing information, and terms of service.
3. To begin the subscription process:
   • Click “View purchase options” to explore available plans.
   • Choose your preferred subscription plan (at the moment, we only offer a pay-as-you-go plan).
   • Click “Subscribe” at the bottom of the page.
   • Proceed to “Set up your account” to finalize your registration.
   • Complete the registration form with the required details.
   • Submit the form and await a confirmation email from our team.

2. Complete Subscription Verification

Once you’ve submitted your subscription:

• Our team will review your application, typically within 24 hours.
• Upon approval, you’ll receive a welcome email confirming access. Your subscription email address is your registered login for the platform.

3. Access the CompactifAI Dashboard

Go to the CompactifAI Dashboard and sign in with your registered email address. You’ll be redirected to Multiverse IAM to complete sign-in with a one-time passcode (OTP) sent to that email.

From the Dashboard, you can:

• View, copy, and rotate your API key.
• Monitor your API usage and token consumption.
• Manage your account settings.

Note

See the Dashboard guide for a full walkthrough of what’s available.

Account Policy

To maintain predictable access control, CompactifAI enforces a 1 AWS Account = 1 email and 1 token policy.

• Each AWS Marketplace subscription must be connected to a single AWS account and email address.
• MultiverseIAM issues exactly one API token for that account; rotate it from the dashboard when needed instead of creating additional tokens.
• To grant access to additional teammates, invite them to subscribe with their own AWS account or contact support to discuss alternatives.

Usage Example

You must include your API key in the Authorization header of each API request using the Bearer token scheme:

Authorization: Bearer YOUR_API_KEY

Example Request

cURL

cURL

curl https://api.compactif.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
  "model": "hypernova-60b",
  "messages": [
    {"role": "user", "content": "Hello!"}
  ]
}'

Python

Python

import requests

api_key = "YOUR_API_KEY"
url = "https://api.compactif.ai/v1/chat/completions"

headers = {
  "Content-Type": "application/json",
  "Authorization": f"Bearer {api_key}"
}

# API request payload
data = {
  "model": "hypernova-60b",
  "messages": [
      {"role": "user", "content": "Hello!"}
  ]
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

JavaScript

JavaScript

async function callCompactifAI() {
const response = await fetch('https://api.compactif.ai/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    model: 'hypernova-60b',
    messages: [
      {role: 'user', content: 'Hello!'}
    ]
  })
});

const data = await response.json();
console.log(data);
}

callCompactifAI();