Models API quickstart - H Platform Docs

Send a screenshot, get back what Holo sees and what it would click.

1

Get an API key

Generate a key on H Platform and export it.

export HAI_API_KEY="your-api-key-here"

The examples use holo4-35b-a3b, a paid model: add credits to use it. On the free tier (no credit card), set model to holo3-1-35b-a3b. All IDs are in Models.

2

Install the OpenAI client

The API is OpenAI-compatible: the official client works, only base_url changes. Skip this step for cURL.

pip install openai

npm install openai

3

Send a screenshot

curl https://api.hcompany.ai/v1/chat/completions \
  -H "Authorization: Bearer $HAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "holo4-35b-a3b",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "image_url", "image_url": {"url": "https://your-host/screenshot.png"}},
        {"type": "text", "text": "What is on this screen, and what would you click to sign in?"}
      ]
    }]
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.hcompany.ai/v1/",
    api_key=os.environ.get("HAI_API_KEY"),
)

response = client.chat.completions.create(
    model="holo4-35b-a3b",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": "https://your-host/screenshot.png"}},
            {"type": "text", "text": "What is on this screen, and what would you click to sign in?"},
        ],
    }],
)

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

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.hcompany.ai/v1/",
  apiKey: process.env.HAI_API_KEY,
});

const response = await client.chat.completions.create({
  model: "holo4-35b-a3b",
  messages: [{
    role: "user",
    content: [
      { type: "image_url", image_url: { url: "https://your-host/screenshot.png" } },
      { type: "text", text: "What is on this screen, and what would you click to sign in?" },
    ],
  }],
});

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

Images can be a URL or a base64 data URI. List the models your key can reach with GET /v1/models.

Related: Build an agent, Cookbooks, Element localization, Document OCR, API reference, Local inference.