Asosiy mazmunga oʻtish

OpenAI bilan mos chat

OpenAI SDKʼni NeuronAIʼga yoʻnaltiring va tashkilotingiz uchun ochiq modellardan chat javoblarini oling.

Qanday ishlaydi

  1. 01

    Mijozning asosiy URL manzilini https://my.neuronai.uz/api/v1 qilib belgilang.

  2. 02

    Model identifikatorlari roʻyxatini GET /models orqali oling.

  3. 03

    messages massivini POST /chat/completions ga yuboring, oqimli javob uchun stream: true qoʻshing.

Autentifikatsiya

OpenAI SDKʼlari kalitni Authorization: Bearer sifatida yuboradi, shuning uchun NeuronAI kalitingizni SDKʼning API kaliti sifatida koʻrsating. Modellar roʻyxati uchun llm:read, chat uchun llm:write ruxsati kerak.

Namuna

Soʻrov va javoblar chat completions shaklini saqlaydi, shuning uchun ilovani oʻtkazish uchun uning sozlamalarini oʻzgartirish kifoya. Xatolar OpenAIʼning xato obyektida, qoʻshimcha request_id bilan keladi.

cURL
curl -X POST "https://my.neuronai.uz/api/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-api-key>" \
  -d '{
    "model": "gemma-4-26b-a4b",
    "messages": [
      {"role": "user", "content": "Salom! Bugun ob-havo qanday?"}
    ]
  }'

API maʼlumotnomasi

Har bir endpoint uchun soʻrov maydonlari, javoblar, narxlar va kod namunalari hamda haqiqiy soʻrov yuboradigan shakl.

Faqat brauzeringizda saqlanadi.

LLM

OpenAI-compatible chat completions. Point any OpenAI SDK at this base URL and authenticate with your API key.

POST
/v1/chat/completions

Bearer

Create chat completion

Generates a model response for a chat conversation. OpenAI-compatible — set your OpenAI SDK's base URL to `{app}/api/v1` and use your API key. Set `stream: true` for a Server-Sent Events stream of `chat.completion.chunk` objects ending with `[DONE]` (the chunk before it carries `usage` when the model reports its token counts). Billed per token (prompt + completion).

Pricing
per 1K tokens
Input
1.5 credits
Output
6 credits
Soʻrov tanasi
application/json
MaydonTavsif
modelMajburiystring

maxLen: 128

max_tokensinteger | null

min: 1

temperaturenumber | null

min: 0 · max: 2

top_pnumber | null

min: 0 · max: 1

stopobject

Text at which the model stops: one string, or a list of strings (OpenAI's `stop`). Sent to the model exactly as given, byte for byte, including a string of only whitespace such as `\n`.

streamboolean | null
messagesMajburiyobject[]
Javoblar
200
The completion: one choice holding the assistant's message, and `usage` counting the tokens billed. With `stream: true`, the completion comes as Server-Sent Events instead (`text/event-stream`).
application/json
text/event-stream
SarlavhaTavsif
X-CostnumberThe price billed, in credits. Sent with the JSON completion; a stream is billed when it ends, so it carries none.
X-Accel-BufferingstringSent as `no` with a stream: it tells a proxy such as nginx not to hold back the events.
X-Request-IdstringIdentifies this request. A JSON body carries it as `request_id` too; quote it to support.
X-RateLimit-LimitintegerThe requests a minute the rate limit on this endpoint allows. Sent once the limit has counted the request, so not when the key itself is refused.
X-RateLimit-RemainingintegerHow many of them are left this minute.
MaydonTavsif
idMajburiystring
objectMajburiystring
createdMajburiyinteger
modelMajburiystring
choicesMajburiyobject[]
usageMajburiyobject
401
The API key is missing or not recognized (`invalid_api_key`), revoked (`api_key_revoked`), disabled (`api_key_disabled`) or expired (`api_key_expired`).
application/json
SarlavhaX-Request-Id: string
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

402
Not enough balance for the most this request can cost (`insufficient_balance`), or that cost would pass this key's monthly spend limit (`spend_limit_exceeded`). Nothing is charged.
application/json
SarlavhaTavsif
X-Request-IdstringIdentifies this request. A JSON body carries it as `request_id` too; quote it to support.
X-RateLimit-LimitintegerThe requests a minute the rate limit on this endpoint allows. Sent once the limit has counted the request, so not when the key itself is refused.
X-RateLimit-RemainingintegerHow many of them are left this minute.
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

403
The key lacks the permission this endpoint needs (`insufficient_permissions`), or the client IP is not in its allowlist (`ip_not_allowed`).
application/json
SarlavhaTavsif
X-Request-IdstringIdentifies this request. A JSON body carries it as `request_id` too; quote it to support.
X-RateLimit-LimitintegerThe requests a minute the rate limit on this endpoint allows. Sent once the limit has counted the request, so not when the key itself is refused.
X-RateLimit-RemainingintegerHow many of them are left this minute.
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

404
`model` is not one of the models `GET /api/v1/models` lists: `model_not_found`.
application/json
SarlavhaTavsif
X-Request-IdstringIdentifies this request. A JSON body carries it as `request_id` too; quote it to support.
X-RateLimit-LimitintegerThe requests a minute the rate limit on this endpoint allows. Sent once the limit has counted the request, so not when the key itself is refused.
X-RateLimit-RemainingintegerHow many of them are left this minute.
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

422
The request failed validation (`invalid_request`: `error.param` names the first invalid field and `error.fields` maps each one to its message), or the prompt, with room for `max_tokens` (the server's cap when it is left out), does not fit the model's context window (`context_length_exceeded`).
application/json
SarlavhaTavsif
X-Request-IdstringIdentifies this request. A JSON body carries it as `request_id` too; quote it to support.
X-RateLimit-LimitintegerThe requests a minute the rate limit on this endpoint allows. Sent once the limit has counted the request, so not when the key itself is refused.
X-RateLimit-RemainingintegerHow many of them are left this minute.
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

429
Too many requests: the per-minute rate limit is used up (`rate_limit_exceeded`), or this key or its organization already has as many requests in flight as it may (`concurrency_limit_exceeded`). Wait `Retry-After` seconds, then retry.
application/json
SarlavhaTavsif
X-Request-IdstringIdentifies this request. A JSON body carries it as `request_id` too; quote it to support.
Retry-AfterintegerSeconds to wait before retrying.
X-RateLimit-LimitintegerThe requests a minute the rate limit on this endpoint allows. Sent once the limit has counted the request, so not when the key itself is refused.
X-RateLimit-RemainingintegerHow many of them are left this minute.
X-RateLimit-ResetintegerWhen the rate limit lets requests through again, as a Unix time in seconds. Sent with a 429 for `rate_limit_exceeded`.
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

502
Without `stream`: the model failed or could not be reached, `upstream_error`. Nothing is charged. A stream reports a failure as an event instead.
application/json
SarlavhaTavsif
X-Request-IdstringIdentifies this request. A JSON body carries it as `request_id` too; quote it to support.
X-RateLimit-LimitintegerThe requests a minute the rate limit on this endpoint allows. Sent once the limit has counted the request, so not when the key itself is refused.
X-RateLimit-RemainingintegerHow many of them are left this minute.
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

default
Any other error, in the same envelope. For example `server_error` (500) when something fails unexpectedly, `service_unavailable` (503) while the API is down for maintenance, or `input_too_large` (413) when the request body is larger than the server accepts.
application/json
SarlavhaTavsif
X-Request-IdstringIdentifies this request. A JSON body carries it as `request_id` too; quote it to support.
Retry-AfterintegerSeconds to wait before retrying. Sent with a 503 during maintenance, when a retry time was set.
X-RateLimit-LimitintegerThe requests a minute the rate limit on this endpoint allows. Sent once the limit has counted the request, so not when the key itself is refused.
X-RateLimit-RemainingintegerHow many of them are left this minute.
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

Namunalar
cURL
curl -X POST "https://my.neuronai.uz/api/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-api-key>" \
  -d '{
    "model": "gemma-4-26b-a4b",
    "messages": [
      {"role": "user", "content": "Salom! Bugun ob-havo qanday?"}
    ]
  }'

Sinab koʻrish

Kalit bilan soʻrov yuborish uchun API kalitingizni yuqoridagi panelga kiriting.

application/json

GET
/v1/models

Bearer

List models

Lists the chat models available to your account.

Javoblar
200
The chat models, in OpenAI's list shape. Send a model's `id` as `model`. `created` is always `0`.
application/json
SarlavhaTavsif
X-Request-IdstringIdentifies this request. A JSON body carries it as `request_id` too; quote it to support.
X-RateLimit-LimitintegerThe requests a minute the rate limit on this endpoint allows. Sent once the limit has counted the request, so not when the key itself is refused.
X-RateLimit-RemainingintegerHow many of them are left this minute.
MaydonTavsif
objectMajburiystring
dataMajburiyobject[]
401
The API key is missing or not recognized (`invalid_api_key`), revoked (`api_key_revoked`), disabled (`api_key_disabled`) or expired (`api_key_expired`).
application/json
SarlavhaX-Request-Id: string
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

403
The key lacks the permission this endpoint needs (`insufficient_permissions`), or the client IP is not in its allowlist (`ip_not_allowed`).
application/json
SarlavhaX-Request-Id: string
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

429
Too many requests: the per-minute rate limit is used up (`rate_limit_exceeded`). Wait `Retry-After` seconds, then retry.
application/json
SarlavhaTavsif
X-Request-IdstringIdentifies this request. A JSON body carries it as `request_id` too; quote it to support.
Retry-AfterintegerSeconds to wait before retrying.
X-RateLimit-LimitintegerThe requests a minute the rate limit on this endpoint allows. Sent once the limit has counted the request, so not when the key itself is refused.
X-RateLimit-RemainingintegerHow many of them are left this minute.
X-RateLimit-ResetintegerWhen the rate limit lets requests through again, as a Unix time in seconds. Sent with a 429 for `rate_limit_exceeded`.
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

default
Any other error, in the same envelope. For example `server_error` (500) when something fails unexpectedly, or `service_unavailable` (503) while the API is down for maintenance.
application/json
SarlavhaTavsif
X-Request-IdstringIdentifies this request. A JSON body carries it as `request_id` too; quote it to support.
Retry-AfterintegerSeconds to wait before retrying. Sent with a 503 during maintenance, when a retry time was set.
X-RateLimit-LimitintegerThe requests a minute the rate limit on this endpoint allows. Sent once the limit has counted the request, so not when the key itself is refused.
X-RateLimit-RemainingintegerHow many of them are left this minute.
MaydonTavsif
errorMajburiyobject
request_idMajburiystring

The same ID as the `X-Request-Id` header.

format: uuid

Namunalar
TypeScript SDK
import {NeuronAI} from "@naiuz/sdk";

const client = new NeuronAI();

const models = await client.models.list();

for (const model of models.data) {
    console.log(model.id);
}

Sinab koʻrish

Kalit bilan soʻrov yuborish uchun API kalitingizni yuqoridagi panelga kiriting.