Loading documentation...
Preparing Ring content
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Preparing Ring content
Preparing Ring content
Preparing Ring content
ring-image-createГенерирует изображение из естественно-языкового prompt, загружает его в ring-filebase, сохраняет строку аудита в generated_images и возвращает постоянный CDN URL.
Операторы и агенты вызывают ring-image-create через ring-mcp. Шлюз бьёт в POST /api/mcp/v1/images/generate, который запускает ImageConductor (lib/images/conductor/image-conductor.ts) с сервисным актором MCP как actorId. Провайдер по умолчанию — xAI (IMAGE_GEN_PROVIDER=xai).
Обзор Ring MCP, область kingdom vs clone, предпосылки.
Архитектура, админ UI, программный API, устранение неисправностей.
Настройка токенов, ring-health, полный каталог инструментов.
Переменные окружения изображений и хранилища на клоне.
| Поле | Значение |
|---|---|
| Имя MCP-инструмента | ring-image-create |
| HTTP-маршрут | POST /api/mcp/v1/images/generate |
| MCP-сервер | AI-RING/ring-mcp/lib/tools.js |
| Обработчик шлюза | app/api/mcp/v1/images/generate/route.ts |
| Conductor | lib/images/conductor/image-conductor.ts |
| Требуется confirm | Нет (генерация + хранение без деструктивных мутаций) |
| Параметр | Обязательный | Тип | Примечания |
|---|---|---|---|
prompt | Да | string | Естественно-языковое описание изображения |
provider | Нет | xai | google | По умолчанию из IMAGE_GEN_PROVIDER (обычно xai) |
model | Нет | string | Переопределение модели провайдера (см. env defaults ниже) |
aspectRatio | Нет | string | xAI: гибкий; Google: 1:1, 3:4, 4:3, 9:16, 16:9 |
OG preset: aspectRatio: "2:1" на xAI (~1200×630). Для Google Imagen используйте 16:9 как ближайшее OG-соотношение.
Попросите подключённого к MCP агента на естественном языке:
Или вызовите инструмент явно:
Включите MCP-шлюз на клоне Ring — задайте RING_MCP_ACCESS_KEY в .env.local и перезапустите npm run dev.
Настройте генерацию изображений — XAI_API_KEY (или GOOGLE_GENAI_API_KEY), плюс ring-filebase (FILE_BACKEND=ringbase, RINGBASE_API_URL, RINGBASE_API_TOKEN).
Зарегистрируйте ring-mcp в Cursor с совпадающими RING_MCP_ACCESS_KEY и RING_API_BASE_URL (напр. http://localhost:3000 для ring-platform.org).
Проверьте — запустите ring-health, затем ring-image-create с коротким тестовым prompt. Ожидайте url в ответе.
Шлюз MCP оборачивает результат conductor в { success, data }:
Миграция data/migrations/006_generated_images_schema.sql добавляет таблицу аудита generated_images (также отражена в data/schema.sql).
| Симптом | Проверка |
|---|---|
Invalid service token / 401 | RING_MCP_ACCESS_KEY в MCP-клиенте совпадает с RING_MCP_ACCESS_KEY на клоне |
prompt is required | Передайте непустой prompt |
XAI_API_KEY is not configured | Ключ в .env.local, перезапустите dev-сервер |
| Upload failed | RINGBASE_API_TOKEN, FILE_BACKEND=ringbase |
| Timeout | Поднимите IMAGE_GEN_POLL_TIMEOUT_MS (по умолчанию 120000) |
| Пустой ответ / policy rejection | Квота провайдера, политика prompt или дрейф имени модели |
Сервисный токен MCP даёт доступ, эквивалентный SUPERADMIN, на клоне — включая генерацию изображений за счёт ключей провайдера. Ротируйте токены по средам; никогда не коммитьте секреты.
ring-image-createГенерирует изображение из естественно-языкового prompt, загружает его в ring-filebase, сохраняет строку аудита в generated_images и возвращает постоянный CDN URL.
Операторы и агенты вызывают ring-image-create через ring-mcp. Шлюз бьёт в POST /api/mcp/v1/images/generate, который запускает ImageConductor (lib/images/conductor/image-conductor.ts) с сервисным актором MCP как actorId. Провайдер по умолчанию — xAI (IMAGE_GEN_PROVIDER=xai).
Обзор Ring MCP, область kingdom vs clone, предпосылки.
Архитектура, админ UI, программный API, устранение неисправностей.
Настройка токенов, ring-health, полный каталог инструментов.
Переменные окружения изображений и хранилища на клоне.
| Поле | Значение |
|---|---|
| Имя MCP-инструмента | ring-image-create |
| HTTP-маршрут | POST /api/mcp/v1/images/generate |
| MCP-сервер | AI-RING/ring-mcp/lib/tools.js |
| Обработчик шлюза | app/api/mcp/v1/images/generate/route.ts |
| Conductor | lib/images/conductor/image-conductor.ts |
| Требуется confirm | Нет (генерация + хранение без деструктивных мутаций) |
| Параметр | Обязательный | Тип | Примечания |
|---|---|---|---|
prompt | Да | string | Естественно-языковое описание изображения |
provider | Нет | xai | google | По умолчанию из IMAGE_GEN_PROVIDER (обычно xai) |
model | Нет | string | Переопределение модели провайдера (см. env defaults ниже) |
aspectRatio | Нет | string | xAI: гибкий; Google: 1:1, 3:4, 4:3, 9:16, 16:9 |
OG preset: aspectRatio: "2:1" на xAI (~1200×630). Для Google Imagen используйте 16:9 как ближайшее OG-соотношение.
Попросите подключённого к MCP агента на естественном языке:
Или вызовите инструмент явно:
Включите MCP-шлюз на клоне Ring — задайте RING_MCP_ACCESS_KEY в .env.local и перезапустите npm run dev.
Настройте генерацию изображений — XAI_API_KEY (или GOOGLE_GENAI_API_KEY), плюс ring-filebase (FILE_BACKEND=ringbase, RINGBASE_API_URL, RINGBASE_API_TOKEN).
Зарегистрируйте ring-mcp в Cursor с совпадающими RING_MCP_ACCESS_KEY и RING_API_BASE_URL (напр. http://localhost:3000 для ring-platform.org).
Проверьте — запустите ring-health, затем ring-image-create с коротким тестовым prompt. Ожидайте url в ответе.
Шлюз MCP оборачивает результат conductor в { success, data }:
Миграция data/migrations/006_generated_images_schema.sql добавляет таблицу аудита generated_images (также отражена в data/schema.sql).
| Симптом | Проверка |
|---|---|
Invalid service token / 401 | RING_MCP_ACCESS_KEY в MCP-клиенте совпадает с RING_MCP_ACCESS_KEY на клоне |
prompt is required | Передайте непустой prompt |
XAI_API_KEY is not configured | Ключ в .env.local, перезапустите dev-сервер |
| Upload failed | RINGBASE_API_TOKEN, FILE_BACKEND=ringbase |
| Timeout | Поднимите IMAGE_GEN_POLL_TIMEOUT_MS (по умолчанию 120000) |
| Пустой ответ / policy rejection | Квота провайдера, политика prompt или дрейф имени модели |
Сервисный токен MCP даёт доступ, эквивалентный SUPERADMIN, на клоне — включая генерацию изображений за счёт ключей провайдера. Ротируйте токены по средам; никогда не коммитьте секреты.
ring-image-createГенерирует изображение из естественно-языкового prompt, загружает его в ring-filebase, сохраняет строку аудита в generated_images и возвращает постоянный CDN URL.
Операторы и агенты вызывают ring-image-create через ring-mcp. Шлюз бьёт в POST /api/mcp/v1/images/generate, который запускает ImageConductor (lib/images/conductor/image-conductor.ts) с сервисным актором MCP как actorId. Провайдер по умолчанию — xAI (IMAGE_GEN_PROVIDER=xai).
Обзор Ring MCP, область kingdom vs clone, предпосылки.
Архитектура, админ UI, программный API, устранение неисправностей.
Настройка токенов, ring-health, полный каталог инструментов.
Переменные окружения изображений и хранилища на клоне.
| Поле | Значение |
|---|---|
| Имя MCP-инструмента | ring-image-create |
| HTTP-маршрут | POST /api/mcp/v1/images/generate |
| MCP-сервер | AI-RING/ring-mcp/lib/tools.js |
| Обработчик шлюза | app/api/mcp/v1/images/generate/route.ts |
| Conductor | lib/images/conductor/image-conductor.ts |
| Требуется confirm | Нет (генерация + хранение без деструктивных мутаций) |
| Параметр | Обязательный | Тип | Примечания |
|---|---|---|---|
prompt | Да | string | Естественно-языковое описание изображения |
provider | Нет | xai | google | По умолчанию из IMAGE_GEN_PROVIDER (обычно xai) |
model | Нет | string | Переопределение модели провайдера (см. env defaults ниже) |
aspectRatio | Нет | string | xAI: гибкий; Google: 1:1, 3:4, 4:3, 9:16, 16:9 |
OG preset: aspectRatio: "2:1" на xAI (~1200×630). Для Google Imagen используйте 16:9 как ближайшее OG-соотношение.
Попросите подключённого к MCP агента на естественном языке:
Или вызовите инструмент явно:
Включите MCP-шлюз на клоне Ring — задайте RING_MCP_ACCESS_KEY в .env.local и перезапустите npm run dev.
Настройте генерацию изображений — XAI_API_KEY (или GOOGLE_GENAI_API_KEY), плюс ring-filebase (FILE_BACKEND=ringbase, RINGBASE_API_URL, RINGBASE_API_TOKEN).
Зарегистрируйте ring-mcp в Cursor с совпадающими RING_MCP_ACCESS_KEY и RING_API_BASE_URL (напр. http://localhost:3000 для ring-platform.org).
Проверьте — запустите ring-health, затем ring-image-create с коротким тестовым prompt. Ожидайте url в ответе.
Шлюз MCP оборачивает результат conductor в { success, data }:
Миграция data/migrations/006_generated_images_schema.sql добавляет таблицу аудита generated_images (также отражена в data/schema.sql).
| Симптом | Проверка |
|---|---|
Invalid service token / 401 | RING_MCP_ACCESS_KEY в MCP-клиенте совпадает с RING_MCP_ACCESS_KEY на клоне |
prompt is required | Передайте непустой prompt |
XAI_API_KEY is not configured | Ключ в .env.local, перезапустите dev-сервер |
| Upload failed | RINGBASE_API_TOKEN, FILE_BACKEND=ringbase |
| Timeout | Поднимите IMAGE_GEN_POLL_TIMEOUT_MS (по умолчанию 120000) |
| Пустой ответ / policy rejection | Квота провайдера, политика prompt или дрейф имени модели |
Сервисный токен MCP даёт доступ, эквивалентный SUPERADMIN, на клоне — включая генерацию изображений за счёт ключей провайдера. Ротируйте токены по средам; никогда не коммитьте секреты.
resolution| Нет |
1k | 2k |
| Уровень разрешения xAI |
n | Нет | number | Число изображений (xAI 1–10, Google 1–4) |
purpose | Нет | string | Сегмент пути хранилища, напр. og, news-featured |
refCode | Нет | string | Опциональный tracking id |
seed | Нет | number | Подсказка воспроизводимости (зависит от провайдера) |
Generate a professional Ring Platform banner with vibrant gradient,
aspect ratio 2:1, purpose og
ring-image-create prompt "community meetup photo, warm lighting" aspectRatio 16:9 purpose news-featuredresolution| Нет |
1k | 2k |
| Уровень разрешения xAI |
n | Нет | number | Число изображений (xAI 1–10, Google 1–4) |
purpose | Нет | string | Сегмент пути хранилища, напр. og, news-featured |
refCode | Нет | string | Опциональный tracking id |
seed | Нет | number | Подсказка воспроизводимости (зависит от провайдера) |
Generate a professional Ring Platform banner with vibrant gradient,
aspect ratio 2:1, purpose og
ring-image-create prompt "community meetup photo, warm lighting" aspectRatio 16:9 purpose news-featuredresolution| Нет |
1k | 2k |
| Уровень разрешения xAI |
n | Нет | number | Число изображений (xAI 1–10, Google 1–4) |
purpose | Нет | string | Сегмент пути хранилища, напр. og, news-featured |
refCode | Нет | string | Опциональный tracking id |
seed | Нет | number | Подсказка воспроизводимости (зависит от провайдера) |
Generate a professional Ring Platform banner with vibrant gradient,
aspect ratio 2:1, purpose og
ring-image-create prompt "community meetup photo, warm lighting" aspectRatio 16:9 purpose news-featured