Quick Start

This guide will help you get up and running with the Hack Club AI API in minutes.

Get an API Key

Create an API key from your dashboard. Give it a descriptive name for easy identification (e.g. CraftAI), and make sure to keep it secure and private!

Make Your First Request

Here's how to make your first API call using different methods:

cURL

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

JavaScript

import { OpenRouter } from "@openrouter/sdk";

const client = new OpenRouter({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://ai.hackclub.com/proxy/v1",
});

const response = await client.chat.send({
  model: "qwen/qwen3-32b",
  messages: [
    { role: "user", content: "Tell me a joke." },
  ],
  stream: false,
});

console.log(response.choices[0].message.content);

Python

from openrouter import OpenRouter

client = OpenRouter(
    api_key="YOUR_API_KEY",
    server_url="https://ai.hackclub.com/proxy/v1",
)

response = client.chat.send(
    model="qwen/qwen3-32b",
    messages=[
        {"role": "user", "content": "Tell me a joke."}
    ],
    stream=False,
)

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

What's Next?

• Authentication - Learn about API key management
• Chat Completions - Generate text responses
• Image Generation - Create images with AI
• Embeddings - Generate vector embeddings