Выполнение кодаготовится

Выполнение кода — это инструмент, который вы включаете в запросе. Модель сама решает, что задачу проще посчитать, а не угадывать: пишет короткую программу, отправляет её в изолированную среду на нашей стороне, получает результат и продолжает ответ уже с числами на руках. Вам не нужно исполнять код у себя — вы получаете готовый вывод в теле ответа.

Включение планируется по конвенции OpenAI — через массив tools. Один вызов инструмента = один запуск среды.

curl https://api.librachat.kz/v1/chat/completions \
  -H "Authorization: Bearer sk-libra-…" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "libra-pro",
    "messages": [
      {"role": "user", "content": "Посчитай сложный процент: 250000 ₽ под 14% годовых, 7 лет, капитализация ежемесячно."}
    ],
    "tools": [{"type": "code_execution"}]
  }'

Планируемый ответ содержит обычный choices[0].message.content, а рядом — запись о запуске: сам код, поток вывода и код завершения.

{
  "id": "chatcmpl-…",
  "model": "libra-pro",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Через 7 лет на счёте будет 663 812,44 ₽.",
      "tool_calls": [{
        "id": "call_01",
        "type": "code_execution",
        "code_execution": {
          "language": "python",
          "code": "p=250000; r=0.14/12; n=12*7\nprint(round(p*(1+r)**n, 2))",
          "stdout": "663812.44\n",
          "stderr": "",
          "exit_code": 0,
          "duration_ms": 412
        }
      }]
    },
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 148, "completion_tokens": 96, "total_tokens": 244}
}

Среда планируется одноразовой: она поднимается на время запроса и удаляется вместе со всем, что в ней создано. Между двумя запросами ничего не сохраняется — переменные, установленные пакеты и временные файлы не переживают ответ.

Отсутствие сети — это не временное ограничение, а способ изоляции. Если модели нужны свежие данные, передавайте их в messages или используйте веб-поиск как отдельный инструмент.

Планируется, что в /workspace можно положить файлы заранее и забрать созданные после запуска. Входные файлы прикрепляются к запросу по идентификаторам, полученным при загрузке; внутри среды они лежат по своим именам.

{
  "model": "libra-pro",
  "messages": [{"role": "user", "content": "Посчитай выручку по месяцам из sales.csv и построй график."}],
  "tools": [{
    "type": "code_execution",
    "code_execution": {"file_ids": ["file_8f21…"]}
  }]
}

Файлы, созданные кодом, планируется возвращать списком в output_files — с именем, размером и идентификатором для скачивания. Живут они ограниченное время (планово 24 часа), затем удаляются. Ограничения: до 20 входных файлов, до 100 МиБ суммарно на запуск, один файл не больше 50 МиБ. Хранение и скачивание тарифицируются отдельно: файлы 6,75 ₽ за ГиБ в сутки, скачивание 54 ₽ за ГиБ.

Выполнение кода планируется тарифицировать поштучно: 1 350 ₽ за 1 000 вызовов, то есть 1,35 ₽ за один запуск среды. Вызовом считается каждый запуск, включая тот, что завершился ошибкой или упёрся в лимит времени — среда всё равно была поднята.

Поверх этого отдельно оплачиваются токены. Код, который написала модель, и вывод программы, который она прочитала, попадают в обычный счёт за токены: libra-fast — 337,50 ₽ за миллион на входе и 675 ₽ на выходе, libra-pro — 450 ₽ и 900 ₽. Длинный вывод программы возвращается модели во вход следующего шага, поэтому печатать в stdout мегабайты дорого: просите модель выводить итог, а не сырые данные.

Ошибка внутри кода — это не ошибка API. Если программа упала, ответ придёт со статусом 200: в stderr будет трассировка, в exit_code — ненулевое значение, а модель, скорее всего, исправит код и запустит его заново (в пределах лимита запусков). Ошибки уровня HTTP планируются те же, что и в остальном API: 401 no_api_key и invalid_api_key, 402 insufficient_balance, 429 rate_limited, 502 upstream_error. К ним добавятся 400 code_execution_unsupported, если инструмент запрошен для модели без его поддержки, и 408 code_execution_timeout, когда запуск не уложился в 30 секунд.