API моделей Looma

API моделей Looma даёт прямой доступ к моделям сети: текст, изображения, видео, эмбеддинги, ранжирование. Запросы совместимы с OpenAI: подойдут существующий код и SDK.

Ключ

Ключ API моделей выпускается в кабинете клиента, кнопкой «Выпустить ключ API моделей». Он показывается один раз. Отзывается там же.

Запрос

curl https://api.loomafloat.ru/v1/chat/completions \
  -H "Authorization: Bearer <ключ API>" \
  -H "Content-Type: application/json" \
  -d '{"model": "<модель>", "messages": [{"role": "user", "content": "Привет"}]}'

С OpenAI SDK для Python:

from openai import OpenAI

client = OpenAI(base_url="https://api.loomafloat.ru/v1", api_key="<ключ API>")
reply = client.chat.completions.create(model="<модель>", messages=[{"role": "user", "content": "Привет"}])

Модели и адреса

Список моделей отдаёт GET /v1/models: имя, тип и цены.

Тип	Что делает	Адрес
text	чат и генерация текста, ответ можно получать потоком	POST /v1/chat/completions
image	изображение по описанию, правка изображения	POST /v1/images/generations, POST /v1/images/edits
video	ролик по описанию, задание на минуты	POST /v1/videos, GET /v1/videos/{id}, GET /v1/videos/{id}/content
embedding	векторы текста	POST /v1/embeddings
rerank	переупорядочить найденное по запросу	POST /v1/rerank

Цены

Цена вызова зависит от модели. В ответе GET /v1/models у модели есть поля цены в копейках: price_in и price_out за миллион входных и выходных токенов, price_image за изображение, price_second за секунду видео. Каждый вызов записывается в кабинет клиента.

Если модель спит

Модель, которой давно не пользовались, спит. Первый вызов будит её: запрос ждёт до 4 минут, а если не дождался, приходит ответ 503 с заголовком Retry-After. Ставьте таймаут клиента не меньше 5 минут и повторяйте запрос после паузы из Retry-After.