API Reference

from openai import OpenAI

client = OpenAI(
    base_url="https://api.rocktalk.ai/v1",
    api_key="sk_rt_YOUR_KEY"
)

response = client.chat.completions.create(
    model="qwen3.5",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain entropy in one paragraph."}
    ],
    max_tokens=512,
    temperature=0.7
)

print(response.choices[0].message.content)
print(response.usage)  # prompt_tokens, completion_tokens, total_tokens

stream = client.chat.completions.create(
    model="qwen3.5",
    messages=[{"role": "user", "content": "Tell me about black holes."}],
    stream=True
)

for chunk in stream:
    delta = chunk.choices[0].delta
    if delta.content:
        print(delta.content, end="", flush=True)

curl https://api.rocktalk.ai/v1/chat/completions \
  -H "Authorization: Bearer sk_rt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.5",
    "stream": true,
    "messages": [
      {"role": "user", "content": "Hello, what can you do?"}
    ]
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "qwen3.5",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Entropy is a measure of..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 143,
    "total_tokens": 167
  }
}

curl https://api.rocktalk.ai/v1/models \
  -H "Authorization: Bearer sk_rt_YOUR_KEY"

{
  "object": "list",
  "data": [{
    "id": "qwen3.5",
    "object": "model",
    "owned_by": "rocktalk-labs"
  }]
}

import requests

res = requests.post(
    "https://api.rocktalk.ai/v1/lens/encode",
    headers={"Authorization": "Bearer sk_rt_YOUR_KEY"},
    json={"text": "love is patient"}
)
data = res.json()
result = data["results"][0]

print(result["coordinates"])     # [0.82, 0.34, ..., 0.91] — 22 floats
print(result["top_dimensions"])  # top activated dimensions

res = requests.post(
    "https://api.rocktalk.ai/v1/lens/encode",
    headers={"Authorization": "Bearer sk_rt_YOUR_KEY"},
    json={"text": [
        "the speed of light",
        "maximum constraint on information transfer",
        "photon velocity in vacuum"
    ]}
)

for r in res.json()["results"]:
    print(r["text"], r["coordinates"][:4], "...")

curl https://api.rocktalk.ai/v1/lens/encode \
  -H "Authorization: Bearer sk_rt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "love is patient"}'

{
  "results": [
    {
      "text": "love is patient",
      "coordinates": [
        0.8234, 0.7102, 0.3045, 0.5567,
        0.6891, 0.7234, 0.2109, 0.8012,
        0.9101, 0.4523, 0.6677, 0.3345,
        0.2234, 0.7890, 0.5012, 0.4101,
        0.3567, 0.8234, 0.2678, 0.1234,
        0.4512, 0.9023
      ],
      "top_dimensions": [
        {"index": 8,  "meaning": "surrounding/goodness", "value": 0.9101},
        {"index": 21, "meaning": "covenant/completion",  "value": 0.9023},
        {"index": 0,  "meaning": "strength/primacy",     "value": 0.8234}
      ]
    }
  ],
  "model": "rocktalk-lens-v1",
  "dimensions": 22
}

res = requests.post(
    "https://api.rocktalk.ai/v1/lens/compare",
    headers={"Authorization": "Bearer sk_rt_YOUR_KEY"},
    json={
        "text_a": "the speed of light",
        "text_b": "maximum constraint on information transfer"
    }
)
data = res.json()
print(data["cosine_similarity"])  # 0.94 — very similar
print(data["l2_distance"])        # Euclidean distance in 22D space

curl https://api.rocktalk.ai/v1/lens/compare \
  -H "Authorization: Bearer sk_rt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text_a": "democracy",
    "text_b": "shared decision structure"
  }'

{
  "cosine_similarity": 0.9412,
  "l2_distance": 0.2341,
  "coordinates_a": [0.82, 0.71, /* ...22 floats */],
  "coordinates_b": [0.79, 0.68, /* ...22 floats */]
}

curl https://api.rocktalk.ai/v1/lens/dimensions \
  -H "Authorization: Bearer sk_rt_YOUR_KEY"

{
  "dimensions": [
    {"index": 0,  "meaning": "strength/primacy"},
    {"index": 1,  "meaning": "house/dwelling/family"},
    /* ... */
    {"index": 21, "meaning": "covenant/completion"}
  ],
  "count": 22,
  "model": "rocktalk-lens-v1"
}