NOA API Network™

The NOA API Network™ provides powerful AI capabilities with context awareness and memory management.

Key Features

• Advanced AI chat capabilities with context awareness
• Self-updating AI memory system (SoulSync™) for maintaining conversation context
• Web browsing and search integration for up-to-date information
• Session management for conversation persistence
• Insights generation from conversation history
• Short-term and long-term memory management for more natural interactions

API usage is subject to rate limits based on your subscription plan:

All API requests require an API key passed via the X-API-Key header.

curl -X POST "https://noa-api-162224918694.europe-west2.run.app/api/chat" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Hello, NOA!"}'

Session Tokens

NOA API uses session tokens to maintain context between requests. Session tokens are automatically created on your first request and returned in the response. Subsequent requests should include the session token in the X-Session-ID header.

curl -X POST "https://noa-api-162224918694.europe-west2.run.app/api/chat" \
  -H "X-API-Key: your-api-key" \
  -H "X-Session-ID: your-session-token" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Hello again!"}'

API keys are tied to specific plans which determine rate limits and available features. To get started, you'll need to obtain an API key from the dashboard.

Sessions in NOA API allow you to maintain context across multiple requests. Each session has its own isolated memory and conversation history.

Sessions expire after 24 hours of inactivity by default. For optimal performance, create new sessions for unrelated conversations.

NOA's memory system is designed to maintain context over long conversations. The memory is divided into two main components:

• Short-term memory: Stores recent conversation messages for immediate context
• Long-term memory: Stores important information transferred from short-term memory for persistent context

After a threshold of messages (default: 10), messages are automatically transferred from short-term to long-term memory, and periodically summarized to maintain efficiency.

Track your API usage and understand how you're consuming the service with detailed analytics.

Session Management

• Use sessions for conversation context across multiple requests
• Keep the returned session token to continue conversations
• Sessions expire after 24 hours of inactivity by default
• Create new sessions for unrelated conversations

Rate Limiting Strategy

• Implement exponential backoff when encountering rate limits
• Read reset time information from 429 responses
• Distribute requests evenly over time
• Consider upgrading your plan if you consistently hit limits

Security

• Store your API key securely
• Use HTTPS for all API requests
• Don't expose your API key in client-side code
• Delete sessions that are no longer needed

SoulSync™ is NOA's AI memory management system that:

• Processes user messages into short-term and long-term memory
• Generates insights from conversations
• Provides more personalized responses over time
• Manages memory overflow for optimal performance

Memory Structure

The NOA memory system has two main components:

• Short-term memory: Recent conversation messages
• Long-term memory: Important information transferred from short-term memory

After a threshold of messages (default: 10), user messages are automatically transferred from short-term to long-term memory.

For consistent and reliable integrations:

• Always check response codes and handle errors appropriately
• Store and reuse session tokens for related conversations
• Use streaming endpoints for better user experience with longer responses
• Generate insights periodically to improve response quality

Sample Implementation (Python)

import requests

API_KEY = "your-api-key-here"
BASE_URL = "https://noa-api-162224918694.europe-west2.run.app"  # Updated deployment URL

# Start a new session
session_response = requests.post(
    f"{BASE_URL}/api/sessions/new",
    headers={"X-API-Key": API_KEY}
)
session_data = session_response.json()
session_id = session_data["session_id"]

# Send a chat message
chat_response = requests.post(
    f"{BASE_URL}/api/chat",
    headers={
        "X-API-Key": API_KEY,
        "X-Session-ID": session_id
    },
    json={"prompt": "Hello, who are you?"}
)

# Print the response
print(chat_response.json())

Sample Implementation (JavaScript)

const API_KEY = "your-api-key-here";
const BASE_URL = "https://noa-api-162224918694.europe-west2.run.app";  // Updated deployment URL

// Start a new session
async function startSession() {
  const response = await fetch(`${BASE_URL}/api/sessions/new`, {
    method: "POST",
    headers: {
      "X-API-Key": API_KEY
    }
  });
  const data = await response.json();
  return data.session_id;
}

// Send a chat message
async function sendMessage(sessionId, message) {
  const response = await fetch(`${BASE_URL}/api/chat`, {
    method: "POST",
    headers: {
      "X-API-Key": API_KEY,
      "X-Session-ID": sessionId,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      prompt: message
    })
  });
  return response.json();
}

// Usage
(async () => {
  const sessionId = await startSession();
  const chatResponse = await sendMessage(sessionId, "Hello, who are you?");
  console.log(chatResponse);
})();

Common HTTP Status Codes

Example Error Responses

Missing API Key

{
  "detail": "API Key is missing. Please provide a valid API key in the X-API-Key header."
}

Invalid API Key

{
  "detail": "Invalid API Key. Please provide a valid API key."
}

Rate Limit Exceeded

{
  "detail": "Resource exhausted. Please try again later. Rate limit exceeded for your plan (normal). Limit resets at 2023-09-30 00:00:00"
}