ai.hackclub.com

Usage

Chat Completions

curl -X POST https://ai.hackclub.com/chat/completions \
    -H "Content-Type: application/json" \
    -d '{
        "messages": [{"role": "user", "content": "Tell me a joke!"}],
        "model": "qwen/qwen3-32b"
    }'

Get Available Models

To get available models:

curl https://ai.hackclub.com/model

Example response: qwen/qwen3-32b, openai/gpt-oss-120b, openai/gpt-oss-20b, meta-llama/llama-4-maverick-17b-128e-instruct

API Parameters

The API accepts all standard OpenAI-style parameters for chat completions:

• messages - Array of message objects with role and content
• model - Choose from available models: qwen/qwen3-32b, openai/gpt-oss-120b, openai/gpt-oss-20b, meta-llama/llama-4-maverick-17b-128e-instruct
• temperature - Controls randomness (0.0 to 2.0)
• max_completion_tokens - Maximum number of tokens to generate
• top_p - Controls diversity via nucleus sampling
• frequency_penalty - Reduces repetition of token sequences
• presence_penalty - Reduces repetition of tokens
• stream - Set to true for streaming responses
• stop - Array of tokens at which to stop generation
• response_format - Format of the response (e.g., JSON mode)
• seed - Integer for random seed to enable deterministic sampling
• tools - List of tools the model may call
• tool_choice - Controls which (if any) tool is called
• include_reasoning - Set to true to include reasoning in responses (reasoning models only)
• reasoning_format - Format for reasoning output (reasoning models only)
• reasoning_effort - Controls the reasoning effort for Qwen models (none or default)

Note: You can specify which model to use with the model parameter. If not specified or if an unavailable model is requested, the first available model (qwen/qwen3-32b) will be used.

Note: Reasoning parameters (include_reasoning and reasoning_format) only work when the currently set model is a reasoning model.

Note: The reasoning_effort parameter only works for Qwen models. Use "none" for fast responses without reasoning or "default" for normal reasoning effort.

Terms

You must be a teenager in the Hack Club Slack. All requests and responses are logged to prevent abuse. Projects only — no personal use. This means you can't use it in Cursor or anything similar for the moment! Abuse means this will get shut down — we're a nonprofit funded by donations.