Alpha Chat API

Integrate Alpha Chat in your product.

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 AI Models for the detailed comparison of each model. The pricing information is available at #api-costs.

Chat Completions

POST/v1/chat/completions

Authorization

HTTPBearer

Header parameters

Body

application/json

model*ModelName

versanexuseclipse

messages*Messages

streamStream

personaPersona

stringnull

json_schemaJson Schema

objectnull

temperatureTemperature

top_pTop P

numbernull

frequency_penaltyFrequency Penalty

numbernull

top_kTop K

integernull

Other propertiesany

Response

200422

Successful Response

Body

application/jsontext/event-stream

Completion response, when stream=False

ChatCompletionstringChatCompletion

Request

JavaScriptCurlPython

const response = await fetch('/v1/chat/completions', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "model": "versa",
      "messages": [
        {
          "role": "system",
          "content": "text"
        }
      ]
    }),
});
const data = await response.json();

Response

200422

{
  "id": "text",
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "logprobs": {
        "content": [
          {
            "token": "text",
            "bytes": [
              0
            ],
            "logprob": 0,
            "top_logprobs": [
              {
                "token": "text",
                "bytes": [
                  0
                ],
                "logprob": 0
              }
            ]
          }
        ],
        "refusal": [
          {
            "token": "text",
            "bytes": [
              0
            ],
            "logprob": 0,
            "top_logprobs": [
              {
                "token": "text",
                "bytes": [
                  0
                ],
                "logprob": 0
              }
            ]
          }
        ]
      },
      "message": {
        "content": "text",
        "refusal": "text",
        "role": "assistant",
        "audio": {
          "id": "text",
          "data": "text",
          "expires_at": 0,
          "transcript": "text"
        },
        "function_call": {
          "arguments": "text",
          "name": "text"
        },
        "tool_calls": [
          {
            "id": "text",
            "function": {
              "arguments": "text",
              "name": "text"
            },
            "type": "function"
          }
        ]
      }
    }
  ],
  "created": 0,
  "model": "text",
  "object": "chat.completion",
  "service_tier": "scale",
  "system_fingerprint": "text",
  "usage": {
    "completion_tokens": 0,
    "prompt_tokens": 0,
    "total_tokens": 0,
    "completion_tokens_details": {
      "accepted_prediction_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 0,
      "rejected_prediction_tokens": 0
    },
    "prompt_tokens_details": {
      "audio_tokens": 0,
      "cached_tokens": 0
    }
  }
}

---

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