Createya MCP & API

Мир нейросетей без границ.

Через MCP или REST. 100+ моделей. Один ключ.

🚀 Быстрый старт · 🤖 MCP · 📡 REST · 🎨 Модели · ⚙️ Подключение · 🏢 Юрлицам · 💬 Поддержка

---

Подключи нейросети Createya к своему AI-агенту через MCP или к своему коду через REST. 100 кредитов бесплатно на старте.

Два пути на выбор:

• 🤖 MCP — для AI-агентов (Claude, Cursor, Cline, Windsurf, Codex, OpenCode). Один URL, OAuth или Bearer — и агент сам видит каталог моделей.
• 📡 REST — для своего кода. Один Bearer-токен, POST /v1/run, готовые примеры на curl / Python / Node.js / Go.

🎯 Зачем это нужно

Эпоха AI-агентов наступила. Claude, Cursor, Cline, OpenCode, Codex — каждую неделю появляется новый агент-фреймворк. Все они работают через MCP (Model Context Protocol) — открытый стандарт от Anthropic для подключения внешних инструментов.

Createya решает 4 типичные проблемы:

И всё это — через MCP (для агентов) или обычный REST (для своего кода).

⚡ За 60 секунд

1. Зарегистрируйся → получи 100 бесплатных кредитов createya.ai

2. Создай API-ключ (формат crya_sk_<32hex>) createya.ai/settings/api-keys

3. Дальше — выбираешь свой путь:

🤖 Если ты строишь AI-агента → одна команда

curl -fsSL https://api.createya.ai/install | bash -s -- crya_sk_YOUR_KEY

Ставит MCP-сервер + скиллы за один запуск. Авто-детект: Claude Code (~/.claude/skills/), opencode (читает то же), Codex CLI / Cursor / OpenClaw (универсальный путь ~/.agents/skills/ по стандарту agentskills.io).

Все скиллы из репозитория ставятся автоматически — добавляем новый = появляется при следующем install. Полезные флаги:

# Посмотреть какие скиллы есть:
curl -fsSL https://api.createya.ai/install | bash -s -- --list

# Поставить только конкретные:
curl -fsSL https://api.createya.ai/install | bash -s -- crya_sk_KEY --skills creative-director

→ Инструкции для всех клиентов

💻 Если ты пишешь свой код → REST

curl -X POST https://api.createya.ai/v1/run \
  -H "Authorization: Bearer crya_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"model":"nano-banana-2","input":{"prompt":"кот на луне"}}'

→ Полные примеры на curl / Python / Node.js / Go

💡 100 кредитов бесплатно на старте. Тарифы и пополнение — на сайте: createya.ai.

🤖 Что делает MCP-сервер

После подключения у вашего агента появляются 4 инструмента:

Endpoint: https://api.createya.ai/mcp Транспорт: Streamable HTTP (MCP spec 2025-06-18) Авторизация: OAuth 2.1 (для Claude.ai) или Bearer-заголовок (для всего остального)

⚙️ Подключение — выберите свой инструмент

A. OAuth — самый простой путь (Claude Desktop / Claude.ai / Claude Code)

1. Claude.ai → Settings → Connectors → Add custom connector Claude Desktop → меню + → Connectors → Add custom connector
2. URL сервера: https://api.createya.ai/mcp
3. Claude откроет страницу авторизации Createya — вставь свой crya_sk_... ключ → Разрешить
4. Готово. Tools (list_models, run_model...) появятся в чате.

💡 Каждому участнику команды — свой ключ. Кредиты списываются с workspace, к которому привязан ключ.

B. Claude Code (CLI)

Один скрипт — ставит MCP и скиллы сразу:

curl -fsSL https://api.createya.ai/install | bash -s -- crya_sk_YOUR_KEY

Или только MCP, без скиллов:

claude mcp add createya "https://api.createya.ai/mcp" \
  --transport http \
  --header "Authorization: Bearer crya_sk_..." \
  --scope user

C. Cursor

~/.cursor/mcp.json (глобально) или .cursor/mcp.json (в проекте):

{
  "mcpServers": {
    "createya": {
      "url": "https://api.createya.ai/mcp",
      "headers": {
        "Authorization": "Bearer crya_sk_..."
      }
    }
  }
}

D. Cline (VS Code)

В settings.json:

{
  "cline.mcpServers": {
    "createya": {
      "type": "streamableHttp",
      "url": "https://api.createya.ai/mcp",
      "headers": { "Authorization": "Bearer crya_sk_..." },
      "disabled": false
    }
  }
}

Тип — streamableHttp (camelCase, без дефиса).

E. Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "createya": {
      "serverUrl": "https://api.createya.ai/mcp",
      "headers": { "Authorization": "Bearer crya_sk_..." }
    }
  }
}

F. OpenAI Codex

MCP напрямую — добавь шаблон из configs/codex.toml в ~/.codex/config.toml:

[mcp_servers.createya]
url = "https://api.createya.ai/mcp"
http_headers = { Authorization = "Bearer crya_sk_..." }
enabled = true

Codex plugin — плагин лежит в plugins/createya-mcp/. Он добавляет карточку Createya в Codex Plugins UI, логотип, MCP-сервер и все Createya skills из репозитория. Подробная инструкция: docs/codex-plugin.md.

skills/ в корне — source of truth. После редактирования skills или assets обнови пакет плагина:

scripts/sync-codex-plugin.sh

CI проверяет, что plugins/createya-mcp/skills/ и plugins/createya-mcp/assets/ не разъехались с корнем.

Codex Desktop:

1. Открой Codex → Plugins → Add marketplace.
2. В поле Источник вставь Createya-ai/Createya-mcp.
3. Git ref не меняй.
4. Выборочные пути оставь пустым.
5. Нажми Add marketplace, найди Createya и установи плагин.

Через терминал:

codex plugin marketplace add Createya-ai/Createya-mcp

Локальная проверка из клона репозитория:

codex plugin marketplace add /path/to/Createya-mcp

После установки пройди авторизацию Createya.

G. OpenCode

См. configs/opencode.json — готовый шаблон.

H. Любой другой MCP-клиент

Готовые конфиги — в папке configs/. Скопируй нужный, замени crya_sk_... на свой ключ — готово.

🎨 Каталог моделей

Полная актуальная документация с примерами на curl/Python/Node.js — на отдельном поддомене docs.createya.ai/models/ (синхронизируется с live API раз в неделю).

Сейчас публично доступны через MCP/REST (5 endpoints)

Coming soon (140+ endpoints)

В работе — открытие публичного доступа к остальным семействам: 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 и др.

📚 Live-каталог через API: GET https://api.createya.ai/v1/models (публичный, без auth) 📖 Маркетинговый обзор моделей: createya.ai/knowledge 📡 Документация API + per-model страницы: docs.createya.ai

💡 Примеры использования

Сгенерировать картинку

Ты: Сгенерируй картинку через Createya — кот на луне в стиле Studio Ghibli, формат 16:9
Агент: [вызывает createya:run_model с model=nano-banana-2]
       → возвращает CDN-ссылку на изображение

examples/01-generate-image.md — больше деталей.

Сгенерировать видео