Chat Completions

POST https://hooshvana.ir/api/v1/chat/completions

curl https://hooshvana.ir/api/v1/chat/completions \
  -H "Authorization: Bearer $HOOSHVANA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "You are a concise assistant. Reply in Persian."},
      {"role": "user", "content": "فرق RAM و حافظه‌ی ذخیره‌سازی چیست؟"}
    ],
    "max_tokens": 300
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1792000000,
  "model": "openai/gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "RAM حافظه‌ی موقت و سریع است..." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 38, "completion_tokens": 112, "total_tokens": 150 }
}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":""}}]}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"سلام"}}]}

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

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[],"usage":{"prompt_tokens":12,"completion_tokens":40,"total_tokens":52}}

data: [DONE]

import os
from openai import OpenAI

client = OpenAI(base_url="https://hooshvana.ir/api/v1", api_key=os.environ["HOOSHVANA_API_KEY"])

stream = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "یک داستان کوتاه درباره‌ی باران بنویس."}],
    stream=True,
    stream_options={"include_usage": True},
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:
        print()
        print("tokens:", chunk.usage.total_tokens)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://hooshvana.ir/api/v1",
  apiKey: process.env.HOOSHVANA_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "openai/gpt-4o-mini",
  messages: [{ role: "user", content: "یک داستان کوتاه درباره‌ی باران بنویس." }],
  stream: true,
  stream_options: { include_usage: true },
});

for await (const chunk of stream) {
  const text = chunk.choices[0]?.delta?.content;
  if (text) process.stdout.write(text);
  if (chunk.usage) console.log("\ntokens:", chunk.usage.total_tokens);
}

import json
import os
from openai import OpenAI

client = OpenAI(base_url="https://hooshvana.ir/api/v1", api_key=os.environ["HOOSHVANA_API_KEY"])

def get_order_status(order_id: str) -> dict:
    # Replace with a real database lookup.
    return {"order_id": order_id, "status": "shipped", "eta": "2 days"}

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_order_status",
            "description": "Get the shipping status of an order by its id.",
            "parameters": {
                "type": "object",
                "properties": {
                    "order_id": {"type": "string", "description": "Order id, e.g. A-1024"}
                },
                "required": ["order_id"],
            },
        },
    }
]

messages = [{"role": "user", "content": "سفارش A-1024 من کجاست؟"}]

first = client.chat.completions.create(
    model="openai/gpt-4o-mini", messages=messages, tools=tools
)
msg = first.choices[0].message

if msg.tool_calls:
    messages.append(msg)  # keep the assistant turn that requested the tools
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        result = get_order_status(**args)
        messages.append({
            "role": "tool",
            "tool_call_id": call.id,
            "content": json.dumps(result, ensure_ascii=False),
        })

    final = client.chat.completions.create(
        model="openai/gpt-4o-mini", messages=messages, tools=tools
    )
    print(final.choices[0].message.content)
else:
    print(msg.content)

import base64

# 1) Public HTTPS URL
by_url = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "در این تصویر چه می‌بینی؟"},
            {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}},
        ],
    }],
)

# 2) Local file as base64 data URL
with open("receipt.png", "rb") as f:
    b64 = base64.b64encode(f.read()).decode()

by_file = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "مبلغ کل این رسید را استخراج کن."},
            {"type": "image_url", "image_url": {"url": f"data:image/png;base64,{b64}"}},
        ],
    }],
)
print(by_file.choices[0].message.content)

resp = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    response_format={"type": "json_object"},
    messages=[
        {"role": "system", "content": "Return JSON with keys: sentiment, summary."},
        {"role": "user", "content": "سفارشم دیر رسید ولی کیفیتش عالی بود."},
    ],
)
print(resp.choices[0].message.content)

{
  "model": "openai/gpt-4o-mini",
  "messages": [{ "role": "user", "content": "نام و شهر را استخراج کن: «مریم از اصفهان پیام داده است.»" }],
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "person",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "city": { "type": "string" }
        },
        "required": ["name", "city"],
        "additionalProperties": false
      }
    }
  }
}

resp = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "شرایط مرجوعی کالا چیست؟"}],
    extra_body={"hooshvana": {"knowledge_base_ids": ["kb_123"]}},
)

const resp = await client.chat.completions.create({
  model: "openai/gpt-4o-mini",
  messages: [{ role: "user", content: "شرایط مرجوعی کالا چیست؟" }],
  hooshvana: { knowledge_base_ids: ["kb_123"] },
});