02Начало работы
Подключение через ИИНовое
Дайте ассистенту нашу документацию — и он напишет интеграцию за вас. У каждой страницы есть текстовая версия, а у всей документации — один файл.
Как дать ассистенту документацию
Выберите способ, который удобнее. Все они работают с любым ассистентом: ChatGPT, Claude, Cursor и другими.
- Скопировать для ИИ
- Кнопка над заголовком каждой страницы кладёт её текст в буфер обмена в формате Markdown. Вставьте текст в чат — ассистент увидит ту же страницу, что и вы.
- Открыть в ChatGPT или Claude
- Две кнопки рядом открывают чат и сразу передают адрес страницы в формате
.md. - Страница в .md
- Добавьте
.mdк адресу любой страницы документации — получите чистый текст без вёрстки, напримерrendergrid.io/.ru/ docs/ quickstart.md - llms.txt
- Список всех страниц с одной строкой о каждой. Ассистент по нему сам выбирает, что прочитать.
- llms-full.txt
- Вся документация одним файлом — для ассистента, которому нужно знать всё сразу.
Начните со страницы «Быстрый старт»: её хватает, чтобы получить первую картинку. Остальное ассистент прочитает по ссылкам из неё.
Готовый запрос для ассистента
Скопируйте текст, подставьте свою задачу и отправьте ассистенту. В нём уже есть правила, которые чаще всего забывают.
Подключи генерацию картинок через Rendergrid API в мой проект. Документация: https://rendergrid.io/ llms.txt Полный текст: https:// rendergrid.io/llms-full.txt Правила: - ключ читай из переменной окружения RENDERGRID_API_KEY, в код его не вставляй; - к каждому запросу генерации добавляй X-Idempotency-Key и сохраняй его для повторов; - статус задачи опрашивай не чаще раза в 5 секунд или принимай вебхук; - картинку из result_urls сразу сохраняй у себя: ссылка живёт сутки; - при ответах 429 и 503 жди столько секунд, сколько указано в Retry-After.
Какие файлы есть у документации
| Адрес | Что внутри | Когда брать |
|---|---|---|
/llms.txt | Список страниц с короткими описаниями | Первое знакомство, поиск нужной страницы |
/llms-full.txt | Весь текст документации | Ассистент должен знать всё и без переходов по ссылкам |
/ru/ | Одна страница в Markdown | Точечный вопрос: вебхуки, ошибки, лимиты |
/openapi.json | Описание всех методов API | Генерация клиента — страница OpenAPI |
/skills/ | Навык для Claude Code, на английском | Вы работаете в Claude Code — раздел «Навыки» |
/skills/ | Правило для Cursor, на английском | Вы работаете в Cursor — раздел «Навыки» |
Файлы обновляются вместе с документацией. Дата последнего обновления указана на каждой странице, а список изменений — в разделе «Что нового».
Файл AGENTS.md для вашего проекта
Положите этот файл в корень репозитория. Многие ассистенты для кода читают его сами и следуют правилам, не дожидаясь напоминаний.
## Rendergrid API - Базовый адрес: https://api.rendergrid.io/ api/ public/ v1 - Авторизация: заголовок `Authorization: Bearer $RENDERGRID_API_KEY`. Ключ — только в переменной окружения, никогда в коде и логах. - Создать картинку: `POST /images/ generate` -> 202 {id, status, task_id, cost}. - Получить результат: `GET /creations/ {id}`, не чаще раза в 5 секунд. Статусы: queued, processing, completed, failed. - Повторы: один `X-Idempotency-Key` на операцию; при повторе тот же ключ. Новая картинка — новый ключ. - Ошибки: смотри `error.code`. При 429 и 503 жди `Retry-After`. - Файлы результатов хранятся сутки — скачивай сразу. - Документация: https:// rendergrid.io/ llms.txt
MCP-сервер
MCP подключает Rendergrid к ассистенту как набор инструментов: он сам создаст картинку, дождётся результата и проверит баланс. Подходит для Claude Desktop, Cursor и других программ с поддержкой MCP. Подключиться можно двумя способами; инструменты и цены у них одни и те же.
Удалённый сервер. Программа подключается к нам по адресу https:// (он же https://) и передаёт ваш ключ API в заголовке Authorization: Bearer или X-API-Key. Ничего устанавливать не нужно. Запрос без ключа получает 401.
{
"mcpServers": {
"rendergrid": {
"url": "https://Локальный мост. Если программа не умеет подключаться по адресу, запустите пакет @rendergrid/mcp через npx: нужен Node.js 22+. Ключ мост читает из переменной окружения.
{
"mcpServers": {
"rendergrid": {
"command": "npx",
"args": ["-y", "@rendergrid/mcp"],
"env": { "RENDERGRID_API_KEY": "rg_live_…" }
}
}
}Вместо rg_live_… вставьте свой ключ: переменные окружения в этом файле не подставляются.
| Инструмент | Что делает | Метод API |
|---|---|---|
generate_image | Создаёт картинку и ждёт результат не дольше 45 секунд | POST /images/ |
get_creation | Возвращает статус и ссылки на файлы; если задание ещё идёт, ждёт до 45 секунд | GET /creations/ |
upload_image | Загружает образец для правки: PNG, JPEG или WebP до 25 МиБ | POST /uploads |
list_models | Показывает модели и цены вашего аккаунта | GET /models |
get_balance | Показывает доступную сумму | GET /balance |
generate_image ждёт результат не дольше 45 секунд. Если картинка за это время не готова, инструмент вернёт id задания и подсказку вызвать get_creation.
Вызывайте get_creation с этим id, не чаще раза в 5 секунд: он тоже ждёт до 45 секунд. Не запускайте generate_image заново — это новый запрос и новое списание.
Ассистент тратит ваш баланс: за каждую картинку списывается цена, как при обычном запросе.
Заведите отдельный ключ только под ассистента: его можно отозвать в любой момент, не трогая остальные интеграции. Задайте ключу месячный лимит трат — это жёсткий предел для этого ключа (подробнее). Файл с настройкой, где лежит ключ, не добавляйте в репозиторий.
Навыки для Claude Code и Cursor
Навык — готовая инструкция для ассистента, который пишет код: как вызывать Rendergrid API, какие поля нужны, как получить результат и что делать при ошибках. Скачайте файл и положите его в проект — ассистент подхватит правила сам. Файлы написаны по-английски: их читает модель, а не человек.
- Claude Code
- Файл
/skills/. Положите его вclaude-code/ SKILL.md .claude/skills/rendergrid/SKILL.mdвашего проекта. - Cursor
- Файл
/skills/. Положите его вcursor/ rendergrid.mdc .cursor/rules/rendergrid.mdcвашего проекта.
Навыки собраны из этой документации и обновляются вместе с ней. Ключ в файл не вписывайте: пусть ассистент читает его из переменной окружения RENDERGRID_API_KEY.
Что не отдавать ассистенту
- Ключ API и секрет вебхуков. Просите ассистента читать их из переменных окружения, а сами значения в чат не вставляйте.
- Данные клиентов. Для примеров берите выдуманные:
you@example.com,5b0214ae-9e39-460a-820a-f6ae3e24400b. - Слепую веру в код. Сверяйте то, что написал ассистент, с этой документацией: особенно ключ повтора, интервал опроса и проверку подписи вебхука.
Частые вопросы
Можно ли просто дать ассистенту ссылку на документацию?
rendergrid.io/. Если не умеет — нажмите «Скопировать для ИИ» и вставьте текст страницы в чат.Безопасно ли давать ассистенту ключ?
RENDERGRID_API_KEY, а само значение в чат не вставляйте.Списываются ли деньги при работе через MCP?
Что делать, если картинка не успела за 45 секунд?
generate_image вернёт id задания и подсказку вызвать get_creation. Вызовите его с этим id, а не запускайте генерацию заново: новый запрос — это новое списание.