Quickstart

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.valarhq.ai/v1", # or read OPENAI_BASE_URL from the environment
    api_key=os.environ["VALAR_API_KEY"],
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.valarhq.ai/v1", // or read OPENAI_BASE_URL from the environment
  apiKey: process.env.VALAR_API_KEY,
});

export VALAR_API_KEY=sk_...
# every call below is a plain HTTPS request with a bearer token:
#   -H "Authorization: Bearer $VALAR_API_KEY"

ticket = (
    "Subject: Charged twice this month\n"
    "I see two identical $49 charges on the 3rd. Can you refund one and "
    "tell me why it happened?"
)

started = client.responses.create(
    model="zai-org/GLM-5.2",
    instructions=(
        "You are a support triage agent. Classify the ticket as one of "
        "billing, technical, or account, then draft a short reply."
    ),
    input=ticket,
    background=True,  # returns a response id right away to poll
)

print("Queued:", started.id)

const ticket =
  "Subject: Charged twice this month\n" +
  "I see two identical $49 charges on the 3rd. Can you refund one and " +
  "tell me why it happened?";

const started = await client.responses.create({
  model: "zai-org/GLM-5.2",
  instructions:
    "You are a support triage agent. Classify the ticket as one of " +
    "billing, technical, or account, then draft a short reply.",
  input: ticket,
  background: true, // returns a response id right away to poll
});

console.log("Queued:", started.id);

curl https://api.valarhq.ai/v1/responses \
  -H "Authorization: Bearer $VALAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "zai-org/GLM-5.2",
    "instructions": "You are a support triage agent. Classify the ticket as one of billing, technical, or account, then draft a short reply.",
    "input": "Subject: Charged twice this month\nI see two identical $49 charges on the 3rd. Can you refund one and tell me why it happened?",
    "background": true
  }'
# → {"id": "resp_...", "status": "queued", ...}

import time

response = started
while response.status in {"queued", "in_progress"}:
    time.sleep(2)
    response = client.responses.retrieve(response.id)

if response.status != "completed":
    raise RuntimeError(f"Task ended as {response.status}")

print(response.output_text)

let response = started;
while (response.status === "queued" || response.status === "in_progress") {
  await new Promise((resolve) => setTimeout(resolve, 2000));
  response = await client.responses.retrieve(started.id);
}

if (response.status !== "completed") {
  throw new Error(`Task ended as ${response.status}`);
}

console.log(response.output_text);

# poll until "status" is "completed", then read output_text
curl https://api.valarhq.ai/v1/responses/resp_YOUR_RESPONSE_ID \
  -H "Authorization: Bearer $VALAR_API_KEY"