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 проти 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 |
| Потрібне підтвердження | Ні (генерація та зберігання без змін) |
| Параметр | Обов’язковий | Тип | Примітки |
|---|---|---|---|
prompt | Так | string | Природномовний опис зображення |
provider | Ні | xai \ | google |
model | Ні | string | Перевизначення моделі провайдера |
aspectRatio | Ні | string | xAI гнучкий; Google: 1:1, 3:4, 4:3, 9:16, 16:9 |
resolution | Ні |
OG-пресет: aspectRatio: "2:1" на xAI (приблизно 1200×630). Для Google Imagen використовуйте 16:9.
Попросіть підключеного до MCP агента природною мовою:
Увімкніть MCP-шлюз у клоні Ring і налаштуйте генерацію зображень.
Зареєструйте ring-mcp у Cursor і перевірте ring-health.
Шлюз MCP обгортає результат conductor у { success, data }.
Міграція data/migrations/006_generated_images_schema.sql додає таблицю аудиту generated_images (також відображену в data/schema.sql).
| Симптом | Перевірка |
|---|---|
Invalid service token / 401 | Токени MCP-клієнта і клону збігаються |
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 |
Сервісний токен 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 проти 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 |
| Потрібне підтвердження | Ні (генерація та зберігання без змін) |
| Параметр | Обов’язковий | Тип | Примітки |
|---|---|---|---|
prompt | Так | string | Природномовний опис зображення |
provider | Ні | xai \ | google |
model | Ні | string | Перевизначення моделі провайдера |
aspectRatio | Ні | string | xAI гнучкий; Google: 1:1, 3:4, 4:3, 9:16, 16:9 |
resolution | Ні |
OG-пресет: aspectRatio: "2:1" на xAI (приблизно 1200×630). Для Google Imagen використовуйте 16:9.
Попросіть підключеного до MCP агента природною мовою:
Увімкніть MCP-шлюз у клоні Ring і налаштуйте генерацію зображень.
Зареєструйте ring-mcp у Cursor і перевірте ring-health.
Шлюз MCP обгортає результат conductor у { success, data }.
Міграція data/migrations/006_generated_images_schema.sql додає таблицю аудиту generated_images (також відображену в data/schema.sql).
| Симптом | Перевірка |
|---|---|
Invalid service token / 401 | Токени MCP-клієнта і клону збігаються |
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 |
Сервісний токен 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 проти 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 |
| Потрібне підтвердження | Ні (генерація та зберігання без змін) |
| Параметр | Обов’язковий | Тип | Примітки |
|---|---|---|---|
prompt | Так | string | Природномовний опис зображення |
provider | Ні | xai \ | google |
model | Ні | string | Перевизначення моделі провайдера |
aspectRatio | Ні | string | xAI гнучкий; Google: 1:1, 3:4, 4:3, 9:16, 16:9 |
resolution | Ні |
OG-пресет: aspectRatio: "2:1" на xAI (приблизно 1200×630). Для Google Imagen використовуйте 16:9.
Попросіть підключеного до MCP агента природною мовою:
Увімкніть MCP-шлюз у клоні Ring і налаштуйте генерацію зображень.
Зареєструйте ring-mcp у Cursor і перевірте ring-health.
Шлюз MCP обгортає результат conductor у { success, data }.
Міграція data/migrations/006_generated_images_schema.sql додає таблицю аудиту generated_images (також відображену в data/schema.sql).
| Симптом | Перевірка |
|---|---|
Invalid service token / 401 | Токени MCP-клієнта і клону збігаються |
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 |
Сервісний токен MCP надає доступ, еквівалентний SUPERADMIN, зокрема до генерації зображень за рахунок ключів провайдера. Ротуйте токени для кожного середовища й ніколи не комітьте секрети.
1k \ |
2k |
n | Ні | number | Кількість зображень (xAI 1–10, Google 1–4) |
purpose | Ні | string | Сегмент шляху сховища, напр. og |
refCode | Ні | string | Необов’язковий ID відстеження |
seed | Ні | number | Підказка відтворюваності |
Generate a professional Ring Platform banner with vibrant gradient,
aspect ratio 2:1, purpose og1k \ |
2k |
n | Ні | number | Кількість зображень (xAI 1–10, Google 1–4) |
purpose | Ні | string | Сегмент шляху сховища, напр. og |
refCode | Ні | string | Необов’язковий ID відстеження |
seed | Ні | number | Підказка відтворюваності |
Generate a professional Ring Platform banner with vibrant gradient,
aspect ratio 2:1, purpose og1k \ |
2k |
n | Ні | number | Кількість зображень (xAI 1–10, Google 1–4) |
purpose | Ні | string | Сегмент шляху сховища, напр. og |
refCode | Ні | string | Необов’язковий ID відстеження |
seed | Ні | number | Підказка відтворюваності |
Generate a professional Ring Platform banner with vibrant gradient,
aspect ratio 2:1, purpose og