WEB6 SDKs

Installation

Quick Start

from web6 import Web6Client

client = Web6Client(token="<your-oasis-jwt>")

# Chat completion
resp = client.complete(
    messages=[{"role": "user", "content": "What is holonic memory?"}],
    provider="auto",
)
print(resp["result"]["content"])

# Streaming
for chunk in client.complete_stream(
    messages=[{"role": "user", "content": "Tell me a story"}]
):
    print(chunk, end="", flush=True)

Common Patterns

Cost preview

est = client.estimate_cost("openai", "gpt-4o", prompt_tokens=500, completion_tokens=200)
print(f"Estimated: ${est['estimatedUSD']:.6f}")

Check quota

usage = client.get_usage(plan="Silver", karma=5000)
print(f"{usage['dailyCallsUsed']} / {usage['dailyCallLimit']} calls today")
print(f"Karma multiplier: {usage['karmaMultiplier']}×")

Context manager

with Web6Client(token="<jwt>") as client:
    resp = client.complete(messages=[{"role":"user","content":"Hello"}])

Video with webhook

result = client.generate_video(
    prompt="A glowing OASIS torus rotating in deep space",
    callback_url="https://your-app.com/webhooks/video",
)

Search + rerank

hits   = client.search("holonic consciousness", max_results=20)
ranked = client.rerank(
    "holonic consciousness",
    [h["snippet"] for h in hits["result"]],
    top_n=5,
)

All Methods

Async Client

from web6 import AsyncWeb6Client

async def main():
    async with AsyncWeb6Client(token="<jwt>") as client:

        # Completion
        resp = await client.complete(
            messages=[{"role": "user", "content": "Hello from async!"}]
        )
        print(resp["result"]["content"])

        # Async streaming
        async for chunk in client.complete_stream(
            messages=[{"role": "user", "content": "Tell me a story"}]
        ):
            print(chunk, end="", flush=True)

        # Cost preview
        est = await client.estimate_cost("openai", "gpt-4o", prompt_tokens=500)
        print(f"${est['estimatedUSD']:.6f}")

FastAPI Example

from fastapi import FastAPI
from web6 import AsyncWeb6Client
import os

app    = FastAPI()
client = AsyncWeb6Client(token=os.environ["WEB6_JWT"])

@app.post("/chat")
async def chat(message: str):
    resp = await client.complete(
        messages=[{"role": "user", "content": message}],
        provider="auto",
    )
    return {"reply": resp["result"]["content"]}

@app.get("/shutdown")
async def shutdown():
    await client.close()

Direct HTTP

Every endpoint accepts JSON and returns an OASISResult envelope. Authenticate with a Bearer JWT or X-Api-Key header.

Chat completion (curl)

curl -X POST https://api.web6.oasisomniverse.one/v1/complete \
  -H "Authorization: Bearer $WEB6_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "auto",
    "messages": [{"role":"user","content":"Hello!"}]
  }'

Streaming (curl)

curl -N -X POST https://api.web6.oasisomniverse.one/v1/complete/stream \
  -H "Authorization: Bearer $WEB6_JWT" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Tell me a story"}]}'

Cost estimate

curl -X POST https://api.web6.oasisomniverse.one/v1/estimate \
  -H "Authorization: Bearer $WEB6_JWT" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openai","model":"gpt-4o","promptTokens":500,"completionTokens":200}'

List models

curl https://api.web6.oasisomniverse.one/v1/models?plan=Bronze \
  -H "Authorization: Bearer $WEB6_JWT"

Check quota

curl "https://api.web6.oasisomniverse.one/v1/usage?plan=Silver&karma=5000" \
  -H "Authorization: Bearer $WEB6_JWT"

Response envelope

{
  "isError": false,
  "message": null,
  "result": { /* endpoint-specific data */ }
}

Rate limit headers (every response)

X-RateLimit-Limit: 1500
X-RateLimit-Remaining: 1453
X-RateLimit-Reset: 1756137600
X-RateLimit-Plan: Silver
X-Karma-Multiplier: 3