REST API

Authorization: Bearer gaia_your_api_key

curl -X POST http://localhost:3000/api/v1/chat/completions \
  -H "Authorization: Bearer gaia_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "proj_abc123",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

{
  "id": "chat_...",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "Hello! How can I help you?"
    }
  }]
}

curl -X POST http://localhost:3000/api/v1/chat/completions \
  -H "Authorization: Bearer gaia_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "proj_abc123",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

# Local
npm run start:headless

# Docker
docker run -p 3000:3000 -e HEADLESS=true gaiaai/gaia

POST /api/auth/create-key
{
  "name": "my-app"
}

Authorization: Bearer gaia_...

const project = await fetch('http://localhost:3000/api/projects/create', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer gaia_...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: "My Agent",
    model: "gpt-4",
    provider: "openai"
  })
});

await fetch('http://localhost:3000/api/knowledge/upload', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer gaia_...' },
  body: formData // your files
});

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'http://localhost:3000/api/v1',
  apiKey: 'gaia_...'
});

const completion = await client.chat.completions.create({
  model: "proj_123", // your project ID
  messages: [{ role: "user", content: "Hello!" }]
});