API Documentation

SolCognia provides a comprehensive RESTful API that enables developers to integrate our AI aggregation platform into their applications.

API Overview

The SolCognia API allows you to:

• Access multiple AI models through unified endpoints

• Execute and manage custom workflows

• Track token balances and rewards

• Manage user authentication and profiles

• Monitor usage analytics and performance

Base URL

https://api.solcognia.xyz/v1

Authentication

All API requests require authentication using an API key:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.solcognia.xyz/v1/models

Quick Start

1. Get Your API Key

• Register for a developer account at solcognia.xyz

• Navigate to your developer dashboard

• Generate your API key and configure permissions

2. Make Your First Request

curl -X POST https://api.solcognia.xyz/v1/models/gpt-4/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "Hello, world!"}
    ]
  }'

3. Handle the Response

{
  "id": "chat-123456",
  "model": "gpt-4",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 12,
    "total_tokens": 22
  },
  "tokens_earned": 5
}

API Sections

Authentication

Learn about API key management, OAuth integration, and security best practices.

AI Models

Access multiple AI models including GPT, Claude, and Gemini through unified endpoints.

Workflows

Create, execute, and manage custom AI workflows programmatically.

Tokens

Track token balances, claim rewards, and manage token-related operations.

Rate Limits

• Free Tier: 100 requests per hour

• Developer Tier: 1,000 requests per hour

• Pro Tier: 10,000 requests per hour

• Enterprise: Custom limits available

Error Handling

The API uses standard HTTP status codes and returns detailed error information:

{
  "error": {
    "code": "invalid_request",
    "message": "The request is missing required parameters",
    "details": {
      "missing_fields": ["messages"]
    }
  }
}

SDKs and Libraries

• JavaScript/TypeScript SDK

• Python SDK

• Go SDK

• Rust SDK

Support

• Documentation: https://docs.solcognia.xyz

• Developer Discord: Join our community for real-time support

• Email: [email protected]

The API is currently in development and will be available with our Q4 2025 developer ecosystem launch.