AiHummer
Аԥсшәа▾
Аиалаҵара
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Chat Completions API

Chat Completions API

v1.0.x · ирҿыцуп 2026-06-26

AiHummer иаарԥшуеит OpenAI-иадҳәалоу HTTP-ахьырргоу заҵә атекстә бжьабыргра разы: POST /v1/chat/completions. Иарбану клиент ма SDK уаанӡа OpenAI Chat Completions аформат зыздыруа AiHummer иацәажәартәуп асаит URL насгьы API калит аԥсахны — AiHummer-ала иҷыдоу акод иаҭахым.

Авторизациа

Аҳәарақәа иавторизациатәуп иужь-иужьтәи API калит ала Bearer-токенс. AiHummer акалитқәа ирымоуп ah- префикс насгьы иргоит асаит аадмин UI ала.

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

[!TIP] Асаит URL ауп шәара ашлюз аадрес. Адефолт аргылара аҿы ашлюз ианалшоит :8780, убри ала ауада-иҟоу аҳәара ицоит http://localhost:8780/v1/chat/completions ахь. Апродукциа аҿы шәара TLS ишьҭыхуеит реверс-прокси ала ашлюз аԥхьа.

Имариоу аҳәара

Ишьҭга JSON-агәы messages ацны, OpenAI ахь иеиԥшҵас. model аҩыхә иалырхуеит амодель (ма агент) шәара иинстанс аҿы иаконфигурированоу.

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
  }'

Иамстримуа ажәап иадгылоит иудыруа Chat Completions аформа:

{
  "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 }
}

Истримуа ажәапқәа (SSE)

Иргала "stream": true ажәап маҷ-маҷ аиура разы Server-Sent Events ала. Зегьы аивент ианагоит chat.completion.chunk дельта, насгьы астрим иҵыхәдоуп ҵыхәтәантәи data: [DONE] ацәаҳәа ала.

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." }
    ]
  }'

Ажәап ауп 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 ауп заҵә ахьырргоу OpenAI-иадҳәалоу ҿахьырҟьаа аҿы. AiHummer иаарԥшуам /v1/models насгьы иаарԥшуам /v1/embeddings — аембеддингқәа ауп аҩныҵҟатәи асубсистема насгьы HTTP ала иаауртәуам. Урҭ амҩақәа иршахымҵакыкуа; урҭ изырҭоит 404.

Адискавери & асхема ҿахьырҟьаа

/v1/models алист ахьыҟам аҟынтә, AiHummer ианагоит даара адискавери-ҿахьырҟьаа, ауаа насгьы амаҵурақәа API аарԥшырц зылшо:

Амҩа Иарбану иаарԥшуа
GET /docs Ауаа ирԥхьартәу адокументациа алагара аҭыԥ
GET /docs/api Интерактив API Explorer
GET /docs/openapi.json OpenAPI 3.x аспецификациа
GET /openapi.json OpenAPI 3.x аспецификациа (хадатә алиас)
GET /docs/llm.json Машьынала иҩуртәу API асводка LLM-ала
GET /llms.txt llms.txt индекс LLM-агентцәа разы 
# Fetch the OpenAPI spec
curl https://your-aihummer.example/openapi.json

Асистема ахьырргоу

Ҩба ихәыҷу, иавторизациамкуа асистема ахьырргоу иацхраауеит иныҟәуа насгьы асааҭ агәаҭара:

Аметоди амҩеи Иазҟьоу
GET /v1/ping Изырҭоит имариоу иныҟәуа ажәап
GET /v1/time Изырҭоит ашлюз ласахаз асервер аамҭа 
curl https://your-aihummer.example/v1/ping
curl https://your-aihummer.example/v1/time

Уаха ахь