API Documentation

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1700000000,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 8,
    "total_tokens": 20
  }
}

data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello"},"finish_reason":null}]}

data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"!"},"finish_reason":null}]}

data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]

# Non-streaming
curl https://aicoordinator.spacebread.dev/v1/chat/completions \
  -H "Authorization: Bearer aic_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

# Streaming
curl https://aicoordinator.spacebread.dev/v1/chat/completions \
  -H "Authorization: Bearer aic_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -N \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ],
    "stream": true
  }'

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023064255, -0.009327292, ...]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 5,
    "total_tokens": 5
  }
}

curl https://aicoordinator.spacebread.dev/v1/embeddings \
  -H "Authorization: Bearer aic_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The quick brown fox jumps over the lazy dog"
  }'

{
  "text": "Good morning, how are you doing today?",
  "duration": 3.5,
  "provider": "openai",
  "model": "whisper-1",
  "fallback_reason": null
}

curl https://aicoordinator.spacebread.dev/v1/audio/transcriptions \
  -H "Authorization: Bearer aic_YOUR_API_KEY" \
  -F model="whisper-1" \
  -F file="@recording.wav" \
  -F response_format="json"

curl https://aicoordinator.spacebread.dev/v1/audio/speech \
  -H "Authorization: Bearer aic_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tts-1",
    "input": "Hello! How are you doing today?",
    "voice": "alloy"
  }' \
  --output speech.mp3

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1700000000,
      "owned_by": "openai"
    },
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "created": 1700000000,
      "owned_by": "openai"
    }
  ]
}

curl https://aicoordinator.spacebread.dev/v1/models \
  -H "Authorization: Bearer aic_YOUR_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": 1,
      "name": "Production Key",
      "scope": "read",
      "active": true,
      "client_app": "My App",
      "request_count": 1542,
      "last_used_at": "2025-01-15T10:30:00Z",
      "expires_at": null,
      "created_at": "2024-12-01T08:00:00Z"
    }
  ]
}

curl https://aicoordinator.spacebread.dev/v1/admin/api_keys \
  -H "Authorization: Bearer aic_YOUR_ADMIN_API_KEY"

// 403 Forbidden
{
  "error": {
    "message": "This endpoint requires an admin-scoped API key.",
    "type": "insufficient_scope",
    "param": null,
    "code": "insufficient_scope"
  }
}

{
  "error": {
    "message": "Human-readable description of the error",
    "type": "error_type",
    "param": null,
    "code": "error_code"
  }
}