GET STARTED · QUICKSTART

Make your first request

This walkthrough takes about two minutes. By the end you'll have a working chat completion against an open-source model running on Hoonify.

1. Set your API key

Export the key as an environment variable so you can re-use it across examples. Hoonify API keys are in the form of hoon_...:

export HOONIFY_API_KEY="<COPY_API_KEY_HERE>"

2. Send a request

The API is OpenAI-compatible — same request shape, same response shape. Be sure to change the model name in the request to the Model ID in your subscription. Pick your language:

curl https://api.hoonify.ai/v1/chat/completions \
  -H "Authorization: Bearer $HOONIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Pro",
    "messages": [
      {"role": "user", "content": "Explain LoRA fine-tuning in one paragraph."}
    ]
  }'

3. Stream the response

Setting stream: true returns chunks as the model generates them. Use this for chat UIs to show first-token latency instead of total latency.

stream = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Pro",
    messages=[{"role": "user", "content": "Tell me a fun fact about octopi."}],
    stream=True,
)

for chunk in stream:
    if len(chunk.choices)>0:
        delta = chunk.choices[0].delta.content
        if delta:
            print(delta, end="", flush=True)

4. Pick a different model

See the inference catalog for the full list. Common identifiers:

Next:Chat completions API