Documentation

Get started

Quickstart

CognitivessAI exposes an OpenAI-compatible API. Use any official OpenAI client — just point base_url at us, set api_key to the ssh-ed25519 ... key you generate in your dashboard, and request model Cognitivess-1.

Get your API key
Create a free account to generate an API key and start building.
Generate API key
⚡ Fastest: run Cognitivess-1 inside your coding tools
Install the cognitivess CLI, save your key once, then launch claude — and Cognitivess-1 takes over right inside Claude Code. The same one-liner powers openclaw, hermes and codex, and you can run any GGUF model fully offline with --local. Full CLI reference →
# 1) Install the CLI (Linux / macOS / WSL — needs only Python 3)
curl -fsSL https://api.cognitivess.com/install | sh

# 2) Save your API key once (prompted securely, not echoed)
cognitivess login

# 3) Launch Claude Code under Cognitivess-1
cognitivess launch claude
Also handy: cognitivess models to list models, cognitivess me for usage & spend, cognitivess pull <name> to download a local GGUF model, cognitivess serve <name> to run it in a browser web UI, and cognitivess launch claude --local <name> to run it inside a coding tool. Your key is stored at ~/.config/cognitivess/config.json, locked to your account.
Prefer using the official OpenAI / Anthropic SDK directly? See below 👇

Choose your language

from openai import OpenAI

client = OpenAI(
    api_key="<YOUR_API_KEY>",  # cheia ssh-ed25519 din dashboard
    base_url="https://api.cognitivess.com/v1"
)

response = client.chat.completions.create(
    model="Cognitivess-1",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, how are you?"}
    ],
    max_tokens=131072,
    temperature=0.7
)

print(response.choices[0].message.content)
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "<YOUR_API_KEY>",  // cheia ssh-ed25519 din dashboard
  baseURL: "https://api.cognitivess.com/v1",
});

const response = await client.chat.completions.create({
  model: "Cognitivess-1",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "Hello, how are you?" },
  ],
  max_tokens: 131072,
  temperature: 0.7,
});

console.log(response.choices[0].message.content);
curl https://api.cognitivess.com/v1/chat/completions \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Cognitivess-1",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello, how are you?"}
    ],
    "max_tokens": 131072,
    "temperature": 0.7
  }'

Capabilities

ServerlessSupported
Function CallingSupported
Structured OutputSupported
ReasoningSupported
Anthropic APISupported
Input Capabilitiestext
Output Capabilitiestext

Authentication

Every request must include your API key in the Authorization header as a bearer token. Your key looks like:

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOx1xMtshDsD7HB0dQ6VRggUK8/a10ixPL5C4oLEucVM

You need an account to generate a key. Sign up free to get yours — it is shown only once, so store it securely.

Models

See the Models page for the full Cognitivess-1 spec and pricing.

Anthropic-compatible API

The platform also speaks the Anthropic Messages API. Use the official Anthropic SDK — point base_url at us and pass your ssh-ed25519 key as api_key (sent as x-api-key).

from anthropic import Anthropic

client = Anthropic(
    api_key="<YOUR_API_KEY>",  # cheia ssh-ed25519 din dashboard
    base_url="https://api.cognitivess.com",  # fara /v1; SDK-ul adauga el
)

message = client.messages.create(
    model="Cognitivess-1",
    max_tokens=131072,
    system="You are a helpful assistant.",
    messages=[
        {"role": "user", "content": "Hello, how are you?"}
    ],
)

print(message.content[0].text)

Requests may also be made with curl using the x-api-key header.

curl https://api.cognitivess.com/v1/messages \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Cognitivess-1",
    "max_tokens": 131072,
    "messages": [{"role":"user","content":"Hello"}]
  }'

Endpoints

  • POST https://api.cognitivess.com/v1/chat/completions — OpenAI-compatible chat completions (stream & non-stream)
  • POST https://api.cognitivess.com/v1/messages — Anthropic Messages API (stream & non-stream)
  • GET https://api.cognitivess.com/v1/models — list available models