Бепул уланиш синови
API ма’лумотномаси
Манзиллар, параметрлар ва жавоб шакллари.
Шу саҳифада
Манзил ва авторизатсия
Жорий тест манзили: https://verum-cabinet-api-preview.sdq-sfb.workers.dev/v1. Уни кабинетдаги манзил билан солиштиринг. Ҳар сўровда Authorization: Bearer <VERUM_API_KEY> сарлавҳасини юборинг. Калитни Урлга қўшманг.
Моделлар рўйхати
GET /v1/models
Authorization: Bearer <VERUM_API_KEY>Сўров танаси ва URL параметрлари керак емас. Жавоб фақат рухсат етилган тест моделини кўрсатади.
{
"object": "list",
"data": [
{
"id": "verum-cabinet-preview-echo",
"object": "model",
"owned_by": "verum"
}
]
}Матнли сўров
POST /v1/chat/completions
Authorization: Bearer <VERUM_API_KEY>
Content-Type: application/json{
"model": "verum-cabinet-preview-echo",
"messages": [
{
"role": "user",
"content": "Hello, Verum!"
}
],
"stream": false,
"max_tokens": 2000
}| Майдон | Талаб |
|---|---|
model | Мажбурий: verum-cabinet-preview-echo |
messages | Мажбурий: фақат битта user хабари |
content | Бўш бўлмаган матн, кўпи билан 8192 UTF-8 байт |
stream | Ихтиёрий; фақат false, стандарт false |
max_tokens | Ихтиёрий; фақат бутун 2000, стандарт 2000 |
Қўшимча майдонлар, масалан temperature ёки tools, қабул қилинмайди. Хабарда фақат role ва content бўлади. Бутун сўров танаси кўпи билан 32768 байт. Байт белгилар сони емас: кирилл ҳарфлари бир нечта байт егаллаши мумкин.
Муваффақиятли жавоб
{
"id": "00000000-0000-4000-8000-000000000001",
"object": "chat.completion",
"created": 1790553600,
"model": "verum-cabinet-preview-echo",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello, Verum!"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 1000,
"completion_tokens": 2000,
"total_tokens": 3000
}
}Муваффақиятли ҳолат — 200. id ва created ўзгарувчан; choices[0].message.content юборилган матнга тенг. usage — сун’ий ҳисоб. Хатода error.code қайтади.
{
"error": {
"code": "invalid_key"
}
}Қўлланмайдиган сўровлар
/v1/responses, /v1/messages, файл юклаш ва бошқарув манзиллари бу API орқали очилмайди. Бошқа йўл/усул ёки URL параметри 404 қайтаради. Оқимли жавоб, воситалар ва суҳбат тарихи ҳозир мавжуд емас.