Quickstart

Make your first authenticated request in three steps.

Your first request

Set your key as an environment variable, then call POST /v1/inference:

curl https://api.clymora.com/v1/inference \
  -H "Authorization: Bearer $CLYMORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "clymora-core",
    "input": "Summarize Q3 results."
  }'

from clymora import Clymora

client = Clymora(api_key=os.environ["CLYMORA_API_KEY"])

resp = client.inference.create(
    model="clymora-core",
    input="Summarize Q3 results.",
)
print(resp.output)

import Clymora from "clymora";

const client = new Clymora({ apiKey: process.env.CLYMORA_API_KEY });

const resp = await client.inference.create({
  model: "clymora-core",
  input: "Summarize Q3 results.",
});
console.log(resp.output);

Authentication

All requests are authenticated with a bearer token. Keep your secret key server-side and never expose it in client code.

Your secret key

Every workspace is issued a live secret key. Include it as a bearer token on every request.

Authorization: Bearer cly_live_9f2c7a...4f8a

Core endpoints

The most common endpoints you will authenticate against:

API reference

The Clymora REST API is organized around resources. All endpoints are served over HTTPS from https://api.clymora.com and return JSON.

POST  /v1/inference

Run a completion against a Clymora model or one of your fine-tunes.

{
  "id": "inf_9f2c7a41",
  "model": "clymora-core",
  "output": "Q3 revenue rose 18% to $4.2B...",
  "usage": { "input_tokens": 12, "output_tokens": 86 }
}

POST  /v1/agents/run

Execute an agent workflow. Agents can reason across multiple steps and call registered tools before returning a final result.

GET  /v1/models

List every model available to your workspace, including base models and your fine-tunes.

PUT  /v1/models/{id}/tune

Start a fine-tuning job on your own dataset. Returns a job handle you can poll or subscribe to via webhooks.

SDKs & libraries

Official clients for Python, Node, Go, and Java — with typed responses, automatic retries, and streaming helpers built in.

Install

pip install clymora

npm install clymora

go get github.com/clymora/clymora-go

<dependency>
  <groupId>com.clymora</groupId>
  <artifactId>clymora-java</artifactId>
  <version>1.4.0</version>
</dependency>

Language clients

Webhooks

Subscribe to inference and training events so your systems react the moment work completes — no polling required.

How it works

Register an HTTPS endpoint in your workspace console and choose the events to subscribe to. Clymora delivers a signed JSON payload to your URL for every matching event, with automatic retries and exponential backoff.

Event types

• inference.completed — a completion finished successfully.
• inference.failed — a completion errored or timed out.
• training.started — a fine-tuning job began.
• training.completed — a fine-tune finished and is ready to deploy.

Example payload

{
  "event": "training.completed",
  "created": 1730583000,
  "data": {
    "model_id": "ft_clymora_core_a1b2",
    "status": "ready"
  }
}

Guides

Practical, end-to-end walkthroughs for the most common Clymora implementation patterns.

Changelog

Everything new on the Clymora platform. Subscribe via the webhooks API to get notified programmatically.

Support

Reach the Clymora engineering team directly. We aim to respond to workspace issues within one business day.

© 2025 Clymora Inc. · Documentation portal · Signed in as aayushkumar@clymora.com