Getting Started with Cientheon APIs

Welcome to the Cientheon Developer Documentation. Our platform exposes a unified set of APIs for AI inference, robotics orchestration, cybersecurity monitoring, and edge device sync — all secured under a single authentication layer.

Base URL: https://api.cientheon.com/v2

New in v2.0 — Multi-modal inference endpoints, RoboFlow swarm controls, and CyberShield real-time threat feeds are now available in production.

Quickstart

Make your first API call in under 2 minutes. You'll need an API key from the Client Portal.

1. Install the SDK

pip install cientheon-sdk

2. Initialize the client

# Python example
from cientheon import CientheonClient

client = CientheonClient(api_key="CIEN_sk_xxxxxxxxxxxxxxxx")

3. Run your first inference

response = client.ai.complete(
    model="cientheon-pro-v2",
    messages=[{"role": "user", "content": "Summarize patient intake data"}],
    temperature=0.3
)
print(response.choices[0].message.content)

Authentication

All requests require a Bearer token in the Authorization header. Keys are scoped per project and rotatable at any time from the Client Portal.

# cURL example
curl https://api.cientheon.com/v2/ai/complete \
  -H "Authorization: Bearer CIEN_sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cientheon-pro-v2",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

AI Inference API

Access Cientheon's foundation models for text, image, and multi-modal reasoning. Models are optimized for low-latency enterprise workloads.

POST /v2/ai/complete Text & multi-modal completions

POST /v2/ai/embed Generate vector embeddings

GET /v2/ai/models List available models

RoboFlow Controls

Orchestrate robotic fleets via REST or WebSocket streams. Compatible with RoboFlow OS v3.x and above.

POST /v2/robo/command Send a command to a robot unit

GET /v2/robo/fleet/status Get real-time fleet telemetry

WS /v2/robo/stream Bi-directional control stream

Core Concepts

Reasoning Engine

Multi-modal foundation model that processes text, images, and sensor data to generate actionable decisions in real time.

Actuator Controls

Low-level command layer for robotic hardware — optimized for RoboFlow OS latency standards under 1ms per cycle.

Edge Sync Layer

Bidirectional data fabric connecting edge devices to cloud AI — with delta compression and offline fallback support.

CyberShield Feed

Real-time threat intelligence stream with AI anomaly scoring, auto-classification, and SIEM-compatible event output.

Cientheon Developer Docs