RawLine / Документация API

Справочник API

OpenAI-совместимый. Базовый URL https://app.rawline.dev, инференс под /v1. Машиночитаемый двойник: openapi.json. Авторизация: Authorization: Bearer rlk_… на каждом вызове /v1/*. Форма ошибок: {"error":{"type":"<код>","message":"…"}} для инференса, {"ok":false,"error":{"code":"<код>"}} для вызовов кабинета.

Быстрый старт

cURL, обычный запрос

curl https://app.rawline.dev/v1/chat/completions \
  -H "Authorization: Bearer rlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Привет!"}],
    "max_tokens": 256,
    "temperature": 0.7
  }'

Python (OpenAI SDK)

# Базовый URL реле + ваш ключ
from openai import OpenAI
client = OpenAI(base_url="https://app.rawline.dev/v1", api_key="rlk_YOUR_KEY")
r = client.chat.completions.create(model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Привет!"}])
print(r.choices[0].message.content)

Node (OpenAI SDK)

// Базовый URL реле + ваш ключ
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://app.rawline.dev/v1", apiKey: "rlk_YOUR_KEY" });
const r = await client.chat.completions.create({ model: "gpt-4o-mini",
  messages: [{ role: "user", content: "Привет!" }] });
console.log(r.choices[0].message.content);

Модели и цены

curl https://app.rawline.dev/v1/models -H "Authorization: Bearer rlk_YOUR_KEY"

Каждая запись содержит id, name, context_length (+ context_source: members = гарантированный минимум среди провайдеров, declared = план оператора), max_output_tokens, supported_parameters, architecture.input_modalities и цены тенанта pricing {prompt, completion} в USD за токен. В списке только обслуживаемые модели: модель, у провайдеров которой нет ключей, скрыта. Модель без цены отвечает 402 price_not_set — задайте цену в дашборде перед вызовом.

Стриминг (SSE)

curl -N https://app.rawline.dev/v1/chat/completions \
  -H "Authorization: Bearer rlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Привет"}],
       "stream":true, "max_tokens": 64}'

Фреймы — это data: {…} чанки OpenAI, завершаются data: [DONE]. Python:

# Стриминг: печатаем дельты по мере прихода
stream = client.chat.completions.create(model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Привет"}], stream=True)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Другие диалекты

Все декодируются в одно IR, идут через одну цепочку отказоустойчивости и биллингуются один раз. Опциональные заголовки: X-Relay-Preset: <имя> применяет пресет, X-Rawline-Session: <id> задаёт область памяти диалога (изолирована по тенанту).

Кабинет

Все вызовы кабинета живут на хосте приложения: кабинет.

Ошибки

Инференс (error.type)

Кабинет (error.code)

Память диалогов

Отправляйте X-Rawline-Session: <id> (любая строка до 128 символов, по умолчанию default), и реле будет подставлять записанные ответы ассистента между отправляемыми вами сообщениями пользователя: пересылайте свои пользовательские реплики (или всю историю) и пропускайте ответы ассистента — реле их восстановит, и провайдер посчитает меньше повторных токенов. Запрос, несущий только совсем новую реплику, не совпадёт с записанным префиксом и уйдёт как есть. Изоляция по тенанту — сессии никогда не протекают между кошельками. Хранятся только завершённые ответы; оборванный ответ не отравляет последующие ходы.

Лимиты

Бюджеты RPM / TPM / конкурентности на ключ отвечают 429 с Retry-After. Попадания в кэш и присоединения к одиночному полёту не тратят апстрим-токены и не требуют холда. Один процесс на базу данных: лимиты действуют на процесс.