Chat with AI

POST

/ai/chat/

Process chat messages and generate AI responses with custom parameters, and usage tracking. Enforces 131K token context limit and 60 requests/minute rate limit with real-time balance validation.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

AI chat completion generated successfully

Body

🟠400

🟠401

🟠402

🟠429

🔴500

🔴502

🔴504

Request Example

Shell

JavaScript

Java

Swift

cURL

Basic RequestAdvanced Request with ParametersStreaming Request

curl --location --request POST 'https://barrack.ai/api/ai/chat/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "openai/gpt-oss-120b",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "What is machine learning?"
        }
    ],
    "stream": false
}'

Response Example

200 - Non-Streaming Response

{
    "id": "chatcmpl-abc123def456",
    "object": "chat.completion",
    "created": 1702234567,
    "model": "openai/gpt-oss-120b",
    "choices": [
        {
            "index": 0,
            "error": {
                "role": "assistant",
                "content": "Machine learning is a subset of artificial intelligence that enables computers to learn from data without explicit programming. It uses algorithms to identify patterns and make decisions based on experience."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 25,
        "completion_tokens": 42,
        "total_tokens": 67
    }
}

Get available AI models

Get AI usage summary