curl --request POST \
  --url https://gateway.widebot.net/api/v1/AQL/chat/completions \
  --header 'Content-Type: application/json' \
  --header 'x-bot: <api-key>' \
  --header 'x-user-auth: <api-key>' \
  --data '
{
  "Message": "اكتب لي مقالاً قصيراً عن أهمية الذكاء الاصطناعي في التعليم",
  "Config": {
    "Temperature": 0.8,
    "MaxTokens": 2048,
    "TopProbability": 0.9,
    "RepetitionPenalty": 0.1
  },
  "PromptStyle": 5
}
'

{
  "StatusCode": 200,
  "Response": {
    "text": "القاهرة هي العاصمة الرسمية لجمهورية مصر العربية...",
    "metadata": {
      "input_tokens": 123,
      "generated_tokens": 123,
      "total_tokens": 123,
      "generation_time": 123
    }
  },
  "Consumption": "147/10000000"
}

Chat Completion

Standard chat completion API that supports both single messages and conversation history for context-aware responses.

Key Features:

Single message or conversation history support
Configurable generation parameters
Arabic language optimization
Token usage tracking

Note: Example requests/responses shown here are illustrative. When using the live “Try it” tool, you may see two responses: an HTTP status preview from the client and the API’s JSON body (StandardResponse envelope).

POST

api

AQL

chat

completions

curl --request POST \
  --url https://gateway.widebot.net/api/v1/AQL/chat/completions \
  --header 'Content-Type: application/json' \
  --header 'x-bot: <api-key>' \
  --header 'x-user-auth: <api-key>' \
  --data '
{
  "Message": "اكتب لي مقالاً قصيراً عن أهمية الذكاء الاصطناعي في التعليم",
  "Config": {
    "Temperature": 0.8,
    "MaxTokens": 2048,
    "TopProbability": 0.9,
    "RepetitionPenalty": 0.1
  },
  "PromptStyle": 5
}
'

{
  "StatusCode": 200,
  "Response": {
    "text": "القاهرة هي العاصمة الرسمية لجمهورية مصر العربية...",
    "metadata": {
      "input_tokens": 123,
      "generated_tokens": 123,
      "total_tokens": 123,
      "generation_time": 123
    }
  },
  "Consumption": "147/10000000"
}

Authorizations

x-user-auth

string

header

required

Your API key from account settings

x-bot

string

header

required

Your bot ID from account settings

Body

application/json

Message

string

The message to send to the AQL model

Example:

"ما هي عاصمة مصر وما أهم معالمها السياحية؟"

ChatHistory

object[]

Optional previous messages for context-aware conversations

Show child attributes

ChatHistory.Role

enum<string>

The role of the message sender

Available options:

User,

Assistant

ChatHistory.Content

string

The message content

Config

object

Configuration parameters for text generation

Show child attributes

Config.Temperature

number<float>

Controls randomness in generation (0.0-1.0)

Required range: 0 <= x <= 1

Example:

0.7

Config.MaxTokens

integer

Maximum number of tokens to generate

Required range: 1 <= x <= 4096

Example:

1024

Config.TopProbability

number<float>

Nucleus sampling probability

Required range: 0 <= x <= 1

Example:

0.9

Config.RepetitionPenalty

number<float>

Penalty for repeating words

Required range: 0 <= x <= 2

Example:

0.1

PromptStyle

integer

Style of response generation:

0: Base (standard responses)
1: Expert (technical/formal)
2: Conversational (casual, dialogic)
3: Structured (organized with sections)
4: Concise (brief, to-the-point)
5: Detailed (comprehensive explanations)

Required range: 0 <= x <= 5

Example:

3

Response

Successful response with generated text

StatusCode

integer

Example:

200

Response

object

Show child attributes

Response.text

string

Generated response text

Example:

"القاهرة هي العاصمة الرسمية لجمهورية مصر العربية..."

Response.metadata

object

Show child attributes

Response.metadata.input_tokens

integer

Number of input tokens processed

Response.metadata.generated_tokens

integer

Number of tokens generated

Response.metadata.total_tokens

integer

Total tokens used

Response.metadata.generation_time

number

Time taken for generation in seconds

Consumption

string

Usage tracking

Example:

"147/10000000"

API Prerequisites Stream Chat Completion

⌘I

Overview

Endpoints

Chat Completion

Authorizations

Body

Response