{
  "markdown": "<div align=\"center\">\n\n<img src=\"assets/logo.png\" alt=\"Createya\" width=\"320\"/>\n\n# Createya MCP & API\n\n### Мир нейросетей без границ.\n#### Через MCP или REST. 100+ моделей. Один ключ.\n\n[![MCP](https://img.shields.io/badge/MCP-2025--06--18-7C3AED?style=flat-square)](https://modelcontextprotocol.io/)\n[![REST](https://img.shields.io/badge/REST-OpenAPI%203.1-3B82F6?style=flat-square)](https://api.createya.ai/v1/openapi.json)\n[![License: MIT](https://img.shields.io/badge/License-MIT-22C55E?style=flat-square)](LICENSE)\n[![No VPN](https://img.shields.io/badge/No%20VPN-required-EF4444?style=flat-square)]()\n[![Models](https://img.shields.io/badge/Models-148%20endpoints-F59E0B?style=flat-square)](docs/models-image.md)\n\n[🚀 Быстрый старт](#-за-60-секунд) · [🤖 MCP](#-что-делает-mcp-сервер) · [📡 REST](#-без-mcp--обычный-rest-api) · [🎨 Модели](#-каталог-моделей) · [⚙️ Подключение](#%EF%B8%8F-подключение-выберите-свой-инструмент) · [🏢 Юрлицам](#-для-юридических-лиц) · [💬 Поддержка](#-связь)\n\n---\n\n**Подключи нейросети Createya к своему AI-агенту через MCP или к своему коду через REST. 100 кредитов бесплатно на старте.**\n\n**Два пути на выбор:**\n- 🤖 **MCP** — для AI-агентов (Claude, Cursor, Cline, Windsurf, Codex, OpenCode). Один URL, OAuth или Bearer — и агент сам видит каталог моделей.\n- 📡 **REST** — для своего кода. Один Bearer-токен, `POST /v1/run`, готовые примеры на curl / Python / Node.js / Go.\n\n</div>\n\n---\n\n## 🎯 Зачем это нужно\n\nЭпоха AI-агентов наступила. Claude, Cursor, Cline, OpenCode, Codex — каждую неделю появляется новый агент-фреймворк. Все они работают через **MCP** (Model Context Protocol) — открытый стандарт от Anthropic для подключения внешних инструментов.\n\nCreateya решает 4 типичные проблемы:\n\n| Проблема | Решение Createya |\n|---|---|\n| Геоблокировки и нужен VPN | Прямой доступ — VPN не требуется |\n| Зарубежные карты не принимают | Карты РФ, СБП, Т-Пэй — оплата в рублях |\n| Десятки сервисов с разными ключами | Каталог моделей через **один API-ключ** |\n| Локальное хранение данных (152-ФЗ) | Все данные хранятся локально, полное соответствие закону |\n| Юрлица и B2B | Договор, счёт, акт. Оплата по безналичному расчёту с НДС |\n\nИ всё это — через **MCP** (для агентов) или обычный **REST** (для своего кода).\n\n---\n\n## ⚡ За 60 секунд\n\n**1. Зарегистрируйся → получи 100 бесплатных кредитов**\n[createya.ai](https://createya.ai)\n\n**2. Создай API-ключ** (формат `crya_sk_<32hex>`)\n[createya.ai/settings/api-keys](https://createya.ai/settings/api-keys)\n\n**3. Дальше — выбираешь свой путь:**\n\n### 🤖 Если ты строишь AI-агента → одна команда\n\n```bash\ncurl -fsSL https://api.createya.ai/install | bash -s -- crya_sk_YOUR_KEY\n```\n\nСтавит MCP-сервер + скиллы за один запуск. Авто-детект: Claude Code (`~/.claude/skills/`), opencode (читает то же), Codex CLI / Cursor / OpenClaw (универсальный путь `~/.agents/skills/` по стандарту [agentskills.io](https://agentskills.io)).\n\nВсе скиллы из репозитория ставятся автоматически — добавляем новый = появляется при следующем `install`. Полезные флаги:\n\n```bash\n# Посмотреть какие скиллы есть:\ncurl -fsSL https://api.createya.ai/install | bash -s -- --list\n\n# Поставить только конкретные:\ncurl -fsSL https://api.createya.ai/install | bash -s -- crya_sk_KEY --skills creative-director\n```\n\n[→ Инструкции для всех клиентов](#%EF%B8%8F-подключение-выберите-свой-инструмент)\n\n### 💻 Если ты пишешь свой код → REST\n```bash\ncurl -X POST https://api.createya.ai/v1/run \\\n  -H \"Authorization: Bearer crya_sk_...\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"nano-banana-2\",\"input\":{\"prompt\":\"кот на луне\"}}'\n```\n[→ Полные примеры на curl / Python / Node.js / Go](#-без-mcp--обычный-rest-api)\n\n> 💡 **100 кредитов бесплатно** на старте. Тарифы и пополнение — на сайте: [createya.ai](https://createya.ai).\n\n---\n\n## 🤖 Что делает MCP-сервер\n\nПосле подключения у вашего агента появляются **4 инструмента**:\n\n| Tool | Описание |\n|---|---|\n| 🔍 **`list_models`** | Каталог всех моделей с `parameters_schema`. Агент сам узнаёт что можно вызывать. |\n| 🎨 **`run_model`** | Запуск генерации: `{ model: <slug или family>, input: {...} }`. Картинка / видео / аудио / текст. |\n| ⏳ **`get_run_status`** | Опросить статус async-задачи (видео обычно генерится 30-180 сек). |\n| 💰 **`get_balance`** | Текущий баланс кредитов workspace. |\n\n**Endpoint:** `https://api.createya.ai/mcp`\n**Транспорт:** Streamable HTTP (MCP spec 2025-06-18)\n**Авторизация:** OAuth 2.1 (для Claude.ai) или Bearer-заголовок (для всего остального)\n\n---\n\n## ⚙️ Подключение — выберите свой инструмент\n\n### A. OAuth — самый простой путь (Claude Desktop / Claude.ai / Claude Code)\n\n1. **Claude.ai** → [Settings → Connectors](https://claude.ai/settings/connectors) → **Add custom connector**\n   **Claude Desktop** → меню `+` → `Connectors` → `Add custom connector`\n2. URL сервера: `https://api.createya.ai/mcp`\n3. Claude откроет страницу авторизации Createya — вставь свой `crya_sk_...` ключ → **Разрешить**\n4. Готово. Tools (`list_models`, `run_model`...) появятся в чате.\n\n> 💡 Каждому участнику команды — свой ключ. Кредиты списываются с workspace, к которому привязан ключ.\n\n### B. Claude Code (CLI)\n\n**Один скрипт — ставит MCP и скиллы сразу:**\n\n```bash\ncurl -fsSL https://api.createya.ai/install | bash -s -- crya_sk_YOUR_KEY\n```\n\nИли только MCP, без скиллов:\n\n```bash\nclaude mcp add createya \"https://api.createya.ai/mcp\" \\\n  --transport http \\\n  --header \"Authorization: Bearer crya_sk_...\" \\\n  --scope user\n```\n\n### C. Cursor\n\n`~/.cursor/mcp.json` (глобально) или `.cursor/mcp.json` (в проекте):\n```json\n{\n  \"mcpServers\": {\n    \"createya\": {\n      \"url\": \"https://api.createya.ai/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer crya_sk_...\"\n      }\n    }\n  }\n}\n```\n\n### D. Cline (VS Code)\n\nВ `settings.json`:\n```json\n{\n  \"cline.mcpServers\": {\n    \"createya\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"https://api.createya.ai/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer crya_sk_...\" },\n      \"disabled\": false\n    }\n  }\n}\n```\n> Тип — `streamableHttp` (camelCase, без дефиса).\n\n### E. Windsurf\n\n`~/.codeium/windsurf/mcp_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"createya\": {\n      \"serverUrl\": \"https://api.createya.ai/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer crya_sk_...\" }\n    }\n  }\n}\n```\n\n### F. OpenAI Codex\n\n**MCP напрямую** — добавь шаблон из [`configs/codex.toml`](configs/codex.toml) в `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.createya]\nurl = \"https://api.createya.ai/mcp\"\nhttp_headers = { Authorization = \"Bearer crya_sk_...\" }\nenabled = true\n```\n\n**Codex plugin** — плагин лежит в [`plugins/createya-mcp/`](plugins/createya-mcp/). Он добавляет карточку Createya в Codex Plugins UI, логотип, MCP-сервер и все Createya skills из репозитория. Подробная инструкция: [`docs/codex-plugin.md`](docs/codex-plugin.md).\n\n`skills/` в корне — source of truth. После редактирования skills или assets обнови пакет плагина:\n\n```bash\nscripts/sync-codex-plugin.sh\n```\n\nCI проверяет, что `plugins/createya-mcp/skills/` и `plugins/createya-mcp/assets/` не разъехались с корнем.\n\nCodex Desktop:\n\n1. Открой Codex → Plugins → Add marketplace.\n2. В поле **Источник** вставь `Createya-ai/Createya-mcp`.\n3. **Git ref** не меняй.\n4. **Выборочные пути** оставь пустым.\n5. Нажми **Add marketplace**, найди **Createya** и установи плагин.\n\nЧерез терминал:\n\n```bash\ncodex plugin marketplace add Createya-ai/Createya-mcp\n```\n\nЛокальная проверка из клона репозитория:\n\n```bash\ncodex plugin marketplace add /path/to/Createya-mcp\n```\n\nПосле установки пройди авторизацию Createya.\n\n### G. OpenCode\n\nСм. [`configs/opencode.json`](configs/opencode.json) — готовый шаблон.\n\n### H. Любой другой MCP-клиент\n\nГотовые конфиги — в папке [`configs/`](configs/). Скопируй нужный, замени `crya_sk_...` на свой ключ — готово.\n\n---\n\n## 🎨 Каталог моделей\n\nПолная актуальная документация с примерами на curl/Python/Node.js — на отдельном поддомене **[docs.createya.ai/models/](https://docs.createya.ai/models/)** (синхронизируется с live API раз в неделю).\n\n### Сейчас публично доступны через MCP/REST (5 endpoints)\n\n| Модель | Тип | Slug | Подробнее |\n|---|---|---|---|\n| **Nano Banana 2** | image | `nano-banana-2` | [docs.createya.ai/models/nano-banana-2](https://docs.createya.ai/models/nano-banana-2) |\n| **Nano Banana 2 Edit** | image (i2i) | `nano-banana-2-edit` | [docs.createya.ai/models/nano-banana-2-edit](https://docs.createya.ai/models/nano-banana-2-edit) |\n| **Nano Banana Pro** | image | `nano-banana-pro` | [docs.createya.ai/models/nano-banana-pro](https://docs.createya.ai/models/nano-banana-pro) |\n| **GPT Image 2** | image | `gpt-image-2` | [docs.createya.ai/models/gpt-image-2](https://docs.createya.ai/models/gpt-image-2) |\n| **GPT Image 2 Edit** | image (i2i) | `gpt-image-2-edit` | [docs.createya.ai/models/gpt-image-2-edit](https://docs.createya.ai/models/gpt-image-2-edit) |\n\n### Coming soon (140+ endpoints)\n\nВ работе — открытие публичного доступа к остальным семействам:\n**FLUX 2 / Kontext** · **Sora 2** · **Veo 3.1** / Fast · **Kling Video O3 / V3 / 4K** · **Seedance 2.0** · **Happy Horse** · **Hailuo 2.3** · **Higgsfield Soul** · **Midjourney** · **Runway Gen-4** · **Recraft** · **Ideogram** · **Imagen** · **Wan** · **Grok Imagine** · **Seedream** и др.\n\n📚 **Live-каталог** через API: `GET https://api.createya.ai/v1/models` (публичный, без auth)\n📖 **Маркетинговый обзор** моделей: [createya.ai/knowledge](https://createya.ai/knowledge)\n📡 **Документация API** + per-model страницы: [docs.createya.ai](https://docs.createya.ai)\n\n---\n\n## 💡 Примеры использования\n\n### Сгенерировать картинку\n\n```\nТы: Сгенерируй картинку через Createya — кот на луне в стиле Studio Ghibli, формат 16:9\nАгент: [вызывает createya:run_model с model=nano-banana-2]\n       → возвращает CDN-ссылку на изображение\n```\n\n[`examples/01-generate-image.md`](examples/01-generate-image.md) — больше деталей.\n\n### Сгенерировать видео\n\n```\nТы: Возьми эту картинку (URL) и оживи через Kling, 5 секунд\nАгент: [вызывает createya:run_model с model=kling-video-o3, image_url=...]\n       → возвращает run_id\n       → через 30-60 сек: createya:get_run_status → готовое видео\n```\n\n[`examples/02-generate-video.md`](examples/02-generate-video.md)\n\n### REST без MCP\n\n- [`examples/05-rest-curl.md`](examples/05-rest-curl.md) — curl (sync + async + upload)\n- [`examples/06-rest-python.md`](examples/06-rest-python.md) — Python client\n- [`examples/07-rest-nodejs.md`](examples/07-rest-nodejs.md) — TypeScript / Node.js / Express / Next.js\n- [`examples/08-rest-go.md`](examples/08-rest-go.md) — Go (stdlib, без зависимостей)\n- [`examples/09-rest-php.md`](examples/09-rest-php.md) — PHP / Laravel / Symfony\n- [`examples/03-async-polling.md`](examples/03-async-polling.md) — async-задачи (видео) с exponential backoff\n- [`examples/04-upload-image.md`](examples/04-upload-image.md) — загрузка картинки для image-to-image\n- [`examples/10-error-handling.md`](examples/10-error-handling.md) — обработка всех ошибок, retry-pattern\n\n---\n\n## 📡 Без MCP — обычный REST API\n\nЕсли ты не агент, а просто разработчик — есть REST API. Один Bearer-токен, один POST, готово.\n\n### Шаг 1 — получить токен\n\n1. Зарегистрируйся на [createya.ai](https://createya.ai) (получишь 100 бесплатных кредитов)\n2. Зайди в [createya.ai/settings/api-keys](https://createya.ai/settings/api-keys)\n3. **Create new key** → дай ему имя (например `my-bot-prod`) → **Create**\n4. **Скопируй ключ** — он показывается **один раз**. Формат: `crya_sk_<32hex>`\n5. Храни как пароль (env var, secret manager, не в git)\n\n### Шаг 2 — первый запрос\n\n```bash\ncurl -X POST https://api.createya.ai/v1/run \\\n  -H \"Authorization: Bearer crya_sk_...\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"model\": \"nano-banana-2\",\n    \"input\": {\n      \"prompt\": \"кот на луне в стиле Studio Ghibli\",\n      \"aspect_ratio\": \"16:9\"\n    }\n  }'\n```\n\n**Ответ:**\n```json\n{\n  \"run_id\": \"run_01HZX...\",\n  \"status\": \"completed\",\n  \"output\": {\n    \"urls\": [\"https://cdn-new.createya.ai/image/profile-id/abc123.png\"]\n  }\n}\n```\n\n### Шаг 3 — Python / Node.js / Go\n\n**Python** (с `requests`):\n```python\nimport os, requests\n\nKEY = os.environ[\"CREATEYA_API_KEY\"]\nr = requests.post(\n    \"https://api.createya.ai/v1/run\",\n    headers={\"Authorization\": f\"Bearer {KEY}\"},\n    json={\"model\": \"nano-banana-2\", \"input\": {\"prompt\": \"кот на луне\"}}\n)\nprint(r.json()[\"output\"][\"urls\"][0])\n```\n\n**Node.js** (нативный fetch, Node 18+):\n```javascript\nconst KEY = process.env.CREATEYA_API_KEY;\nconst r = await fetch(\"https://api.createya.ai/v1/run\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${KEY}`,\n    \"Content-Type\": \"application/json\"\n  },\n  body: JSON.stringify({\n    model: \"nano-banana-2\",\n    input: { prompt: \"кот на луне\" }\n  })\n});\nconst json = await r.json();\nconsole.log(json.output.urls[0]);\n```\n\n**Go**:\n```go\nbody := strings.NewReader(`{\"model\":\"nano-banana-2\",\"input\":{\"prompt\":\"кот на луне\"}}`)\nreq, _ := http.NewRequest(\"POST\", \"https://api.createya.ai/v1/run\", body)\nreq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"CREATEYA_API_KEY\"))\nreq.Header.Set(\"Content-Type\", \"application/json\")\nresp, _ := http.DefaultClient.Do(req)\n```\n\n→ Полные примеры: [`examples/05-rest-curl.md`](examples/05-rest-curl.md), [`examples/06-rest-python.md`](examples/06-rest-python.md), [`examples/07-rest-nodejs.md`](examples/07-rest-nodejs.md)\n\n### Async-задачи (видео, длинная музыка)\n\n```bash\n# Шаг 1 — запуск\ncurl -X POST https://api.createya.ai/v1/run \\\n  -H \"Authorization: Bearer crya_sk_...\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"kling-video-o3\",\"input\":{\"image_url\":\"https://...\",\"duration\":5}}'\n# → 202 Accepted, { \"run_id\": \"run_01J2...\", \"status\": \"queued\" }\n\n# Шаг 2 — polling каждые 10 сек\ncurl https://api.createya.ai/v1/runs/run_01J2... \\\n  -H \"Authorization: Bearer crya_sk_...\"\n# → { \"status\": \"completed\", \"output\": { \"url\": \"https://cdn-new.createya.ai/video/...\" } }\n```\n\n### Все REST-эндпоинты\n\n| Метод | URL | Что делает |\n|---|---|---|\n| `GET` | `/v1/models` | Каталог всех моделей с `parameters_schema` |\n| `POST` | `/v1/run` | Запустить генерацию |\n| `GET` | `/v1/runs/{run_id}` | Статус async-задачи |\n| `GET` | `/v1/balance` | Баланс кредитов workspace |\n| `POST` | `/v1/uploads` | Загрузить картинку/видео в Createya CDN (для image-to-image) |\n| `GET` | `/v1/openapi.json` | OpenAPI 3.1 спека (для автогенерации SDK) |\n\n### Машиночитаемые спеки\n\n- **OpenAPI 3.1**: `https://api.createya.ai/v1/openapi.json` — для автогенерации Python/TypeScript/Java/Ruby SDK\n- **llms.txt**: `https://api.createya.ai/llms.txt` — карта API для AI-агентов\n- **Полная документация**: [createya.ai/api](https://createya.ai/api)\n\n---\n\n## 🏢 Для юридических лиц\n\nCreateya работает с компаниями по договору и безналу.\n\n- **Безналичный расчёт** — выставляем счёт, оплата с расчётного счёта компании\n- **Договор + акт** — закрывающие документы для бухгалтерии\n- **НДС** — счета с НДС или без, по запросу\n- **Объёмные пакеты** — оптовая скидка обсуждается индивидуально\n- **API под нагрузку** — повышенные rate limits, выделенные ключи на сервисы\n- **152-ФЗ** — все данные хранятся локально, полное соответствие закону «О персональных данных»\n- **White-label** — Telegram-бот / web под вашим брендом возможен\n\n📩 Реквизиты и счёт за 1 рабочий день: [support@createya.ai](mailto:support@createya.ai)\n\n---\n\n## 🔐 Безопасность\n\n- **API-ключи** — формат `crya_sk_<32hex>`, хранятся хешированно (bcrypt)\n- **Workspace isolation** — ключ привязан к одному workspace, не может списать кредиты с другого\n- **OAuth 2.1 + PKCE** — для web-клиентов (Claude.ai)\n- **Rate limits** — на уровне ключа, защита от утечек\n- **152-ФЗ** — все данные хранятся локально\n\n---\n\n## 📚 Документация\n\n| Документ | Где |\n|---|---|\n| Quickstart REST | [createya.ai/api/getting-started](https://createya.ai/api/getting-started) |\n| Полная REST-спека | [createya.ai/api/rest](https://createya.ai/api/rest) |\n| MCP-коннектор | [createya.ai/api/mcp](https://createya.ai/api/mcp) |\n| OpenAPI 3.1 | [api.createya.ai/v1/openapi.json](https://api.createya.ai/v1/openapi.json) |\n| Каталог моделей | [createya.ai/knowledge](https://createya.ai/knowledge) |\n| Примеры в этом репо | [`examples/`](examples/) |\n\n---\n\n## 💬 Связь\n\n- 🌐 **Сайт:** [createya.ai](https://createya.ai)\n- 📚 **База знаний:** [createya.ai/knowledge](https://createya.ai/knowledge)\n- 🤖 **Telegram-бот** (для генерации напрямую без кода): [@createya_bot](https://t.me/createya_bot)\n- 📧 **Поддержка:** [support@createya.ai](mailto:support@createya.ai)\n- 💼 **Партнёрство / Амбассадорам:** [createya.ai/ambassador](https://createya.ai/ambassador)\n\n---\n\n## 🤝 Контрибьютим\n\nPRs welcome — новый MCP-клиент конфиг, новый язык в примерах, фикс опечатки. См. [CONTRIBUTING.md](CONTRIBUTING.md) для guideline'ов.\n\nНашёл баг или хочешь модель — открой [issue](https://github.com/Createya-ai/createya-mcp/issues/new/choose).\n\nУязвимость? Не открывай публичный issue — пиши на [security@createya.ai](mailto:security@createya.ai). См. [SECURITY.md](SECURITY.md).\n\n---\n\n## 📄 Лицензия\n\n[MIT](LICENSE) — бери, форкай, делай свои интеграции. Только укажи нас как автора.\n\n---\n\n<div align=\"center\">\n\n**Createya — мир нейросетей без границ. Для AI-агентов всего мира.**\n\n⭐ Поставь звезду если репо помог!\n\n</div>\n",
  "bytes": 17214,
  "sha": "302ea3a77d60e5c55e0c93e2f7dc3d324fb0f344e648bf34f516a25093210ddd",
  "repo_slug": "createya-ai/createya-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_createya_ai_createya_mcp_93ef2a91/readme"
}