Atoma provides a fully compatible OpenAI API that allows you to access decentralized AI capabilities while maintaining privacy and security. This guide will help you get started with using the API.

​
Authentication

All API requests require authentication using a bearer token, you can get your API key from the Atoma Dashboard. Include your API key in the Authorization header: 
Authorization: Bearer <YOUR_API_KEY>

​
Base URL

All API endpoints are accessible through the base URL: 
https://api.atoma.network

​
Available Endpoints

Atoma provides the following endpoints:

​
Standard Endpoints (OpenAI Compatible)

  • Chat Completions: /v1/chat/completions
  • Embeddings: /v1/embeddings
  • Image Generations: /v1/images/generations
  • Models: /v1/models

​
Confidential Computing Endpoints

  • Confidential Chat: /v1/confidential/chat/completions
  • Confidential Embeddings: /v1/confidential/embeddings
  • Confidential Images: /v1/confidential/images/generations

​
Nodes

  • Node Registration: /v1/nodes
  • Node Lock Creation: /v1/nodes/lock
The nodes endpoints allow for:
  • Node registration and public address updates in the network
  • Creating node locks for confidential computing
  • Managing node public keys for encrypted communication

​
Key Features

  1. OpenAI Compatibility
    • Drop-in replacement for OpenAI API
    • Supports all standard OpenAI endpoints
    • Compatible with existing OpenAI client libraries
  2. Privacy and Security
    • Support for confidential computing
    • Trusted Execution Environments (TEEs)
    • End-to-end encryption for sensitive data
  3. Distributed Infrastructure
    • Global network of compute nodes
    • Intelligent load balancing
    • High availability and fault tolerance

​
Quickstart with SDKs

Atoma provides official SDKs for easy integration:

​
TypeScript/JavaScript

import { AtomaSDK } from "atoma-sdk";

const atomaSDK = new AtomaSDK({
  bearerAuth: process.env["ATOMASDK_BEARER_AUTH"] ?? "",
});

async function run() {
  const result = await atomaSDK.chat.create({
    messages: [
      { role: "user", content: "Hello!" }
    ],
    model: "meta-llama/llama-3.3-70b-instruct"
  });
  console.log(result);
}

​
Python

from atoma_sdk import AtomaSDK
import os

with AtomaSDK(
    bearer_auth=os.getenv("ATOMASDK_BEARER_AUTH", ""),
) as atoma_sdk:
    result = atoma_sdk.chat.create(
        messages=[
            {"role": "user", "content": "Hello!"}
        ],
        model="meta-llama/llama-3.3-70b-instruct"
    )
    print(result)