Quickstart

Hive is an OpenAI-compatible API gateway. If your tooling already speaks the OpenAI API, it speaks Hive. This page covers your first request, pointing an existing SDK at the gateway, and self-hosting with Hive EnterpriseEdge.

Your first request

Send a chat completion with curl. Replace $HIVE_API_KEY with the key from your console.

curl https://api-hive.scubed.co/v1/chat/completions \
  -H "Authorization: Bearer $HIVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hive-default",
    "messages": [{ "role": "user", "content": "Hello!" }],
    "stream": false
  }'

Use an existing SDK

You do not need a new client library. Point an official OpenAI SDK at the Hive base URL and pass your Hive key. Below is the Python SDK; the JavaScript and Java SDKs follow the same pattern.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api-hive.scubed.co/v1",
    api_key=os.environ["HIVE_API_KEY"],
)

resp = client.chat.completions.create(
    model="hive-default",
    messages=[{"role": "user", "content": "Hello from Dhaka!"}],
)
print(resp.choices[0].message.content)

• Streaming works the same way: pass stream=True.
• Files and media endpoints are available on the same base URL.
• Use the public model aliases: hive-default, hive-fast, or hive-auto.

Self-host with EnterpriseEdge

Hive EnterpriseEdge runs the gateway, developer console and chat workstation on a single machine. Anything Docker can run, EnterpriseEdge can run. Install with one command:

• Pair with Ollama to serve open models entirely on-device.
• The bundled chat workstation is built on Open WebUI.
• Your prompts and data stay on your own infrastructure by default.

Hardware advisor (planned)

On the roadmap: an advisor that reports what your machine can comfortably run, so you can size a box once instead of guessing. The plan is to look at available memory and compute and suggest a model tier that will run smoothly on-device. Until it ships, size against the model requirements published by Ollama for the models you intend to run.

Prepaid credits

Hive Cloud is prepaid. Top up a credit balance in Bangladeshi Taka and spend it as you go, with no subscription and no foreign card.

• Top up via bKash or SSLCommerz.
• Card payments are also supported through Stripe.
• Track balance, keys and usage in the developer console.