Wizard API

Integrate AI chat in your product.

Chat API has been deprecated in favor of the 🧙🏻‍♂️ AIKEK Wizard, our new method of delivering our Universal AI Agents and Fractal data infra to B2B.

The API endpoint for Alpha Chat is compatible with OpenAI's Chat Completion API and can be used as a drop-in replacement by changing three lines of code:

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_TOKEN_HERE",  # Replace OpenAI's token with AlphaKEK's
    base_url="https://api.alphakek.ai/v1"  # Switch to Alpha API server
)

response = client.chat.completions.create(
  model="nexus",  # Switch to Nexus model with crypto knowledge
  messages=[
    {"role": "user", "content": "What to expect from Ethereum ETFs?"}
  ]
)

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: "YOUR_TOKEN_HERE", // Replace OpenAI's token with AlphaKEK's
    baseURL: 'https://api.alphakek.ai/v1' // Switch to Alpha API server
});

const response = await client.chat.completions.create({
    model: "nexus", // Switch to Nexus model with crypto knowledge
    messages: [{
        "role": "user",
        "content": "What to expect from Ethereum ETFs?"
    }]
});

Available models: versa, nexus, eclipse. Refer to Universal AI Agents for the detailed comparison of each model. The pricing information is available at #api-costs.

Chat Completions

post

/v1/chat/completions

Authorizations

Header parameters

turnstile-authorizationany of

Body

modelstring · enumrequired

Options: versa, nexus, eclipse

streamboolean · default: false

temperaturenumber · default: 0.7

messagesobject[]required

personaany of

json_schemaany of

top_pany of · default: 0.95

frequency_penaltyany of · default: 1.17

top_kany of · default: 50

Responses

text/event-streamapplication/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/chat/completions' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "versa",
    "stream": false,
    "temperature": 0.7,
    "messages": [
      {
        "content": "text",
        "role": "system"
      }
    ],
    "persona": "text",
    "json_schema": {},
    "top_p": 0.95,
    "frequency_penalty": 1.17,
    "top_k": 50
  }'

200

422

200

text/event-stream

application/json

text/event-stream

data: {... see ChatCompletion ...} \n\n data: ... \n\n ... data: [DONE]

Successful Response

---

JSON Schema

To enable JSON-constrained generation, pass json_schema argument to the extra_body field:

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.alphakek.ai/v1"
)
messages = [
    {
        "role": "user",
        "content": "Write 5 tweets about crypto ETF news in a JSON format."
    },
]

response = client.chat.completions.create(
    model='nexus',
    messages=messages,
    extra_body={
        'json_schema': {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
                "tweet1": {
                    "type": "string"
                },
                "tweet2": {
                    "type": "string"
                },
                "tweet3": {
                    "type": "string"
                },
                "tweet4": {
                    "type": "string"
                },
                "tweet5": {
                    "type": "string"
                }
            },
            "required": [
                "tweet1",
                "tweet2",
                "tweet3",
                "tweet4",
                "tweet5"
            ]
        }
    }
)

response_text = response.choices[0].message.content
print(response_text)

JavaScript

import OpenAI from 'openai';

const apiKey = "YOUR_API_KEY";
const client = new OpenAI({
    apiKey: apiKey,
    baseURL: 'https://api.alphakek.ai/v1'
});

const question = "Write 5 tweets about crypto ETF news in a JSON format.";
console.log("Question:", question);

try {
    const response = await client.chat.completions.create({
            model: "nexus",
            messages: [{
                role: 'user',
                content: question
            }],
            json_schema: {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {
                    "tweet1": {
                        "type": "string"
                    },
                    "tweet2": {
                        "type": "string"
                    },
                    "tweet3": {
                        "type": "string"
                    },
                    "tweet4": {
                        "type": "string"
                    },
                    "tweet5": {
                        "type": "string"
                    }
                },
                "required": [
                    "tweet1",
                    "tweet2",
                    "tweet3",
                    "tweet4",
                    "tweet5"
                ]
            }
        },
    );
    const response_text = response.choices[0].message.content;
    console.log("Response:\n", response_text);

} catch (error) {
    console.error('Error handling:', error);
}

Sample output:

```json
[
    {
        "text": "🚀 #Ethereum #ETFs expected to attract $15B in investments within 18 months of launch. First ETFs predicted to drop this summer. Time to load up the bags! #Crypto #ETH"
    },
    {
        "text": "#VanEck files for a spot #Solana ETF, sending $SOL surging over 6%. Will this be the next big thing after their successful $BTC and $ETH ETFs? Place your bets! 🤑 #Crypto"
    },
    {
        "text": "The battle of the #SmartContract platforms: While $SOL surges on ETF news, analysts predict slower but steadier growth for $AVAX. Which horse are you backing? #CryptoBets"
    },
    {
        "text": "#Ethereum #ETF launch might be postponed until after July 4th due to paperwork issues. Don't worry, it's still coming! Time to stack more $ETH while it's still cheap! 💰 #BuyTheDip"
    },
    {
        "text": "#21Shares joins the race to launch a #Solana ETF. Will this be the first spot $SOL ETF? Let's goooooo! 🚀 #CryptoNews"
    }
]
```

---

Limitations

• Function calling is not supported (except for the functions of Alpha Alerts API that are being called automatically by nexus and eclipse models.

This list of limitations is subject to change.

---

Chat API Costs

The pricing for Chat API is per request and depends on the model used. Learn more about API Credits at API Pricing.

Model	API Credits per request
Versa	1
Nexus	2
Eclipse	3

API Usage Examples