Документация Ellami

Начните за несколько шагов#

Установите Ellami Agentic IDE#

Приложение Ellami работает на macOS. Публичная загрузка установщика готовится.

Вход и обновление

В приложении начните вход через Ellami Console, откройте страницу с кодом и подтвердите доступ в своём аккаунте. После подтверждения вернитесь в IDE. API-ключ можно подключить как дополнительный способ входа. Для обновления завершите Ellami, откройте новый DMG и замените приложение в «Программах». Проверьте версию в «Настройки → О приложении».

Подключите API-ключ#

1. Войдите в Ellami Console и откройте API-ключи.
2. Создайте отдельный ключ для устройства или приложения. Укажите понятное имя и нужный лимит.
3. Скопируйте секрет сразу: полный ключ показывается один раз. Подключите его в Agentic IDE или сохраните на сервере в ELLAMI_KEY.

Работайте с проектом#

Откройте папку проекта в Agentic IDE. Агент использует файлы, редактор и терминал на вашем компьютере. Задайте цель, ожидаемый результат и ограничения: что нужно изменить, как это проверить и какие части проекта сохранить.

Исправь форму входа: покажи ошибку рядом с полем,
сохрани текущий дизайн и проверь сценарий в браузере.

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

Чат, Preview и проверка

Можно начать чат без проекта: агент работает в домашней папке и по запросу открывает созданную папку в IDE. В панели справа доступны файлы, Preview и браузер. Для статического HTML используйте кнопку HTML; для Vite или Next.js сначала запустите dev-сервер и введите его локальный адрес. После задачи просмотрите изменённые файлы и результаты проверок. Откат файлов не отменяет команды или внешние действия.

Copilot

Кнопка Copilot открывает помощника по обучению: он спрашивает об опыте и цели, объясняет код и сообщения агента. В меню сообщения выберите вопрос к Copilot. Передача открытого файла включается отдельно. Copilot не изменяет файлы и не запускает команды.

Лимит задачи и голосовой ввод

В «Настройки → Общее» задайте лимит новой задачи в USD; пустое поле использует лимит сервера. При исчерпании лимита следующий запрос не выполняется. Крупную оценку расхода нужно подтвердить отдельно. Кнопка микрофона записывает речь; остановка записи отправляет распознанный текст вместе с черновиком. Для нового запроса при ошибке распознавания нужна новая запись.

Продолжите с телефона#

В IDE откройте «Настройки → Подключение» и включите подключения с телефона. Откройте Remote в браузере телефона, войдите в тот же аккаунт и выберите Mac. Сравните код подключения и подтвердите телефон на Mac. Компьютер должен быть включён, а Agentic IDE — подключена: файлы и команды остаются на Mac.

С телефона можно отправлять задачи, выбирать модель и усилие, подтверждать действия, останавливать работу и читать файлы проекта. Для установки на главный экран iPhone используйте «Поделиться → На экран Домой». Preview передаёт локальные страницы и GET-ресурсы; отправка форм и соединения HMR/WebSocket через него не поддерживаются. Уведомления требуют разрешения браузера; на iPhone — установленной PWA.

Создавайте изображения и видео#

Откройте Graphics в консоли и выберите «Изображения» или «Видео». Опишите результат, при необходимости добавьте свой референс и выберите модель. Для изображений доступны качество и число вариантов, если модель их поддерживает. Для видео выберите длительность, формат и разрешение из доступных значений; одна генерация создаёт отдельную сцену.

Перед генерацией баланс резервируется. Цена «от» у видео — нижняя граница, а не точная стоимость выбранной сцены. Неиспользованный резерв возвращается после расчёта. Отмена после отправки провайдеру не гарантирует возврат понесённых расходов. При недоступности сервиса проверьте статус в консоли; видео требует работающего сервера выполнения.

Public API для вашего приложения#

Отдельный OpenAI-совместимый текстовый API. Он принимает model и messages и возвращает JSON или поток SSE. Храните ключ только на сервере.

curl https://www.ellami.pro/api/v1/chat/completions \
  -H "Authorization: Bearer $ELLAMI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-request-001" \
  -d '{"model":"gpt-6-luna","reasoning_effort":"high","messages":[{"role":"user","content":"Hello, Ellami"}],"max_tokens":256,"stream":false}'

const response = await fetch("https://www.ellami.pro/api/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ELLAMI_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID()
  },
  body: JSON.stringify({
    model: "gpt-6-luna",
    reasoning_effort: "high",
    messages: [{ role: "user", content: "Hello, Ellami" }],
    max_tokens: 256,
    stream: false
  })
});
const result = await response.json();
if (!response.ok) throw new Error(result.message || result.error?.message || "Request failed");
console.log(result.choices[0].message.content);

import os, uuid, requests

response = requests.post(
    "https://www.ellami.pro/api/v1/chat/completions",
    headers={
        "Authorization": "Bearer " + os.environ["ELLAMI_KEY"],
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "model": "gpt-6-luna",
        "reasoning_effort": "high",
        "messages": [{"role": "user", "content": "Hello, Ellami"}],
        "max_tokens": 256,
        "stream": False,
    },
    timeout=120,
)
response.raise_for_status()
print(response.json()["choices"][0]["message"]["content"])

Текст ответа: choices[0].message.content. Сначала проверяйте HTTP-статус. Для новой операции создавайте новый Idempotency-Key. В примерах используется GPT-6 Luna: сначала убедитесь, что её id есть в каталоге. Для повторной отправки сохраните исходный Idempotency-Key. Поток включён для всех доступных вашему ключу текстовых моделей с capabilities.streaming: true. Возможность потока не гарантирует текущую доступность модели у провайдера. Несколько ответов n > 1, Responses и native Anthropic API пока не поддерживаются.

Цена и кеширование

Public API использует официальные Standard-цены разработчиков моделей без наценки Ellami. Актуальная ставка в USD за миллион токенов возвращается в pricing из /api/v1/models: input, output, cachedInput и priceTiers для длинного контекста. Действующие промотарифы учитываются автоматически. Кеш создаётся провайдером; скидка применяется только к подтверждённым cached_tokens в usage. Ответы разных запросов в Ellami не кешируются. Повтор с тем же Idempotency-Key возвращает уже сохранённый ответ без нового списания.

OpenAI-совместимые клиенты: baseURL / base_url — https://www.ellami.pro/api/v1, apiKey / api_key — ваш ключ Ellami. Используйте chat.completions и id модели из каталога. Для потока задайте stream: true и stream_options: { include_usage: true }. Ключ храните в переменной окружения на сервере. По умолчанию пространство допускает 60 API-запросов в минуту и 8 параллельных запросов; HTTP 429 содержит Retry-After. Ошибки возвращают объект error с message, type, param и code, а X-Request-Id помогает найти операцию.

Поток и восстановление

Текст и аргументы функций приходят в choices[0].delta. Финальный finish_reason, ellami_usage и [DONE] отправляются после расчёта. HTTP 200 сам по себе не подтверждает успешное завершение потока: ошибка после его начала приходит отдельным SSE-событием error. При обрыве проверьте GET /api/v1/requests/{requestId} с тем же ключом: settled содержит сохранённый response; running требует ожидания; uncertain — сверки через поддержку. Повтор с тем же Idempotency-Key и исходным телом возвращает сохранённый поток без нового списания. Отмена останавливает чтение, но при неизвестном расходе резерв сохраняется.

Подтверждение оценки

HTTP 409 с code: PREFLIGHT_REQUIRED означает, что сначала нужно согласовать расход из details.estimatedUsd. После согласия повторите исходный запрос с тем же Idempotency-Key, добавив ellami_quote_id из details.quoteId и ellami_confirm_estimate: true. Если тело изменилось или оценка истекла, получите новую оценку. Не подтверждайте её автоматически без решения пользователя.

Успешный ответ содержит usage и ellami_usage с данными использования и списания. Ошибки имеют code и message; проверяйте их перед чтением choices. При request_in_progress сохраняйте исходный ключ операции, а при reconciliation_required дождитесь сверки через поддержку.

Модели и актуальные цены#

Основные модели из каталога Ellami. Ниже — базовые цены провайдеров в USD; итоговый тариф и доступность проверяйте в консоли. Каталог проверен: 2026-10-07.

OpenAI

GPT 6.1 Sol

Код, документы и сложные задачи в одном рабочем процессе.

Вход$2.00Выход$10.00

за 1 млн токенов · базовый тариф

OpenAI

GPT 6 Luna

Лёгкая модель для кода, быстрых ответов и массовых задач.

Вход$0.10Выход$0.50

за 1 млн токенов · базовый тариф

Anthropic

Claude Sonnet 5.5

Разработка функций, исправление ошибок и работа с документами.

Вход$2.00Выход$10.00

за 1 млн токенов · базовый тариф

Anthropic

Claude Opus 5.5

Сложный код, ревью и продолжительные агентные задачи.

Вход$4.00Выход$20.00

за 1 млн токенов · базовый тариф

Google

Gemini 3.8 Flash

Мультимодальный анализ, код и многошаговые задачи.

Вход$1.50Выход$7.50

за 1 млн токенов · базовый тариф

DeepSeek

DeepSeek V4.1 Flash

Код, рассуждения и визуальный анализ с большим контекстом.

Вход$0.30Выход$1.20

за 1 млн токенов · базовый тариф

Alibaba Cloud

Qwen 3.8 Flash

Код, визуальное понимание и анализ длинного видео.

Вход$0.15Выход$0.47

за 1 млн токенов · базовый тариф

Z.ai

GLM 5.3 Flash

Быстрая мультимодальная модель для кода и визуального анализа.

Вход$0.15Выход$0.50

за 1 млн токенов · базовый тариф

MiniMax

MiniMax M3

Мультимодальная разработка и агентные задачи.

Вход$0.30Выход$1.20

за 1 млн токенов · базовый тариф

OpenAI

GPT Image 2.5 Sunburst

Создание и редактирование изображений по тексту и референсам.

За изображение$0.01

1024×1024 · medium · вход отдельно

Google

Nano Banana 2

Генерация и редактирование изображений с выводом до 4K.

За изображение$0.07

1K · 1024×1024 · вход отдельно

Google

Veo 3.1 Fast

Быстрая генерация видео со звуком для итераций и готового контента.

За секунду$0.10

720p · вход отдельно

Список доступных моделей Public API и пользовательские цены публикуются в каталоге. Используйте канонический id модели из ответа, а не отображаемое имя.

curl https://www.ellami.pro/api/v1/models \
  -H "Authorization: Bearer $ELLAMI_KEY"

В Agentic IDE стоимость зависит от модели и фактических входных, выходных и кэшированных токенов. Для Public API действуют отдельные ставки входа, выхода и кэша. Цены и расход проверяйте в консоли перед длительной работой. Раздел «Модели» описывает более широкий каталог; доступность конкретного id для Public API проверяйте через GET /api/v1/models. Пустой список означает, что публичные маршруты ещё не настроены.

Баланс, лимиты и бонусы#

Использование списывается с баланса по серверным ценам. Перед запросом сумма резервируется, после ответа неиспользованная часть возвращается. Резерв уменьшает доступный остаток, но ещё не является окончательным расходом. Баланс в USD общий для IDE, API, агентов и графики. В консоли видны остаток и история расходов. Лимит ключа ограничивает расход этого ключа; бюджет задачи помогает контролировать длительную работу агента.

При первом пополнении вы оплачиваете на 15% меньше выбранной суммы, а баланс получает её целиком. Промобаланс и скидка предоставляются сервером один раз. Промобаланс нельзя вывести или перевести. Разовое пополнение доступно от $3 без обязательной подписки. Автопополнение включается отдельно при доступном способе оплаты; задайте порог, сумму и месячный лимит. Проверяйте итоговую сумму и статус платежа в консоли; тестовый платёж не списывает деньги.

Если что-то не работает#

Для Remote проверьте подключение Mac и Agentic IDE. Для проблем с ключом создайте новый ключ и подключите его заново.