AiHummer
Oʻzbekcha▾
KirishShaxsiy kabinet
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Chat Yakunlari API

Chat Yakunlari API

v1.2.x · yangilandi 2026-06-26

AiHummer bitta narsani oshkor qiladi OpenAI bilan mos Matn navlari uchun HTTP oxiri nuqtasi: POST /v1/chat/completions. OpenAI Chat Completions formatida allaqachon so‘zlasha oladigan har qanday mijoz yoki SDK AiHummer bilan bazaviy URL va API kalitini o‘zgartirish orqali muloqot qila oladi — AiHummer-ga xos kod talab qilinmaydi.

Autentifikatsiya

So‘rovlar bilan autentifikatsiya qilinadi shaxsiy API kaliti Bearer token sifatida. AiHummer kalitlarining boshida ah- va veb admin UI dan chiqariladi.

POST /v1/chat/completions HTTP/1.1
Host: your-aihummer.example
Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

[!TIP] Asosiy URL sizning darvozangiz manzili hisoblanadi. Standart o‘rnatishda darvoza tinglaydi ommaviy portda :8780, shuning uchun mahalliy qo’ng’iroq boradi http://localhost:8780/v1/chat/completions. Shlyuz o’z portlariga ega to‘g‘ridan-to‘g‘ri — oldiga teskari proksi qo‘yish operatorning tanlovidir, emas talab.

Asosiy soʻrov

JSON tanasini yuboring messages, aniq OpenAIga qilganingizdek. model maydon sizning instantsiyangizda sozlangan modelni (yoki agentni) tanlaydi.

curl https://your-aihummer.example/v1/chat/completions \
  -H "Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "default",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "Summarise our refund policy in two sentences." }
    ],
    "temperature": 0.3
  }'

Non-striming javob tanish Chat Completions shaklini davom ettiradi:

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1750000000,
  "model": "default",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Refunds are issued within 14 days..." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 0 }
}

Oqim javoblari (SSE)

Oʻrnatish "stream": true javobni qisman qabul qilish uchun Server tomonidan yuborilgan voqealar. Har bir voqea o’zida bir narsani olib keladi chat.completion.chunk delta, va oqim oxirida yakunlanadi data: [DONE] chiziq.

curl -N https://your-aihummer.example/v1/chat/completions \
  -H "Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "default",
    "stream": true,
    "messages": [
      { "role": "user", "content": "Write a one-line greeting." }
    ]
  }'

Javob shunday text/event-stream:

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

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

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

data: [DONE]

[!WARNING] /v1/chat/completions bo‘lib turadi faqat OpenAI-ga mos endpoint sirt. AiHummer qiladi emas ochib ko‘rsatmoq /v1/models va qiladi emas ochib ko‘rsatmoq /v1/embeddings — embeddings ichki subsistema bo‘lib, ularga kirish imkoni yo‘q HTTP orqali. U shablonlarga tayanmang; ular 404 qaytaradi.

Kashfiyot va sxema yuzalari

Hech bo’lmaganda /v1/models listing, AiHummer bir nechta kashfiyot sirtlarini yuboradi, shunda odamlar va vositalar API ni o‘rganishi mumkin:

Yo’l Nima xizmat qiladi
GET /docs Inson o‘qiy oladigan hujjat kirish nuqtasi
GET /docs/api Interaktiv API Tadqiqotchisi
GET /docs/openapi.json OpenAPI 3.x spetsifikatsiyasi
GET /openapi.json OpenAPI 3.x spetsifikatsiyasi (ildiz aliasi)
GET /docs/llm.json LLM vositalari uchun mashina o‘qiy oladigan API xulosası
GET /llms.txt llms.txt LLM agentlari uchun indeks 
# Fetch the OpenAPI spec
curl https://your-aihummer.example/openapi.json

Tizim tugun nuqtalari

Ikkita engil, autentifikatsiyasiz tizim tuguni hayotiylik va soat tekshiruvlariga yordam beradi:

Usul va yo‘l Maqsad
GET /v1/ping Oddiy jonlilik javobini qaytaradi
GET /v1/time Shlyuzning joriy server vaqtini qaytaradi 
curl https://your-aihummer.example/v1/ping
curl https://your-aihummer.example/v1/time

Keyingi qayerga