io.github.Createya-ai/createya-mcp

Official

by Createya-ai · Shell

Createya — AI Image & Video Generation

100+ AI models: FLUX, Sora, Veo, Kling, Runway, Suno. OAuth or Bearer. No VPN. RU billing.

Access 100+ AI models for image, video, and music generation.

Topics

ai-image-generationai-video-generationclaudeclaude-codeclinecodexcursorfluxklingmcpmcp-servermidjourneyopenapirest-apirunwaysorasunoveowindsurfopencode

README.md21 KBView on GitHub

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.

</div>

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

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

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

Проблема	Решение Createya
Геоблокировки и нужен VPN	Прямой доступ — VPN не требуется
Зарубежные карты не принимают	Карты РФ, СБП, Т-Пэй — оплата в рублях
Десятки сервисов с разными ключами	Каталог моделей через один API-ключ
Локальное хранение данных (152-ФЗ)	Все данные хранятся локально, полное соответствие закону
Юрлица и B2B	Договор, счёт, акт. Оплата по безналичному расчёту с НДС

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

⚡ За 60 секунд

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

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

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

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

bash

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. Полезные флаги:

bash

# Посмотреть какие скиллы есть:
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

bash

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 инструмента:

Tool	Описание
🔍 `list_models`	Каталог всех моделей с `parameters_schema`. Агент сам узнаёт что можно вызывать.
🎨 `run_model`	Запуск генерации: `{ model: <slug или family>, input: {...} }`. Картинка / видео / аудио / текст.
⏳ `get_run_status`	Опросить статус async-задачи (видео обычно генерится 30-180 сек).
💰 `get_balance`	Текущий баланс кредитов workspace.

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)

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

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

B. Claude Code (CLI)

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

bash

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

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

bash

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 (в проекте):

json

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

D. Cline (VS Code)

В settings.json:

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:

json

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

F. OpenAI Codex

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

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 обнови пакет плагина:

bash

scripts/sync-codex-plugin.sh

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

Codex Desktop:

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

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

bash

codex plugin marketplace add Createya-ai/Createya-mcp

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

bash

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)

Модель	Тип	Slug	Подробнее
Nano Banana 2	image	`nano-banana-2`	docs.createya.ai/models/nano-banana-2
Nano Banana 2 Edit	image (i2i)	`nano-banana-2-edit`	docs.createya.ai/models/nano-banana-2-edit
Nano Banana Pro	image	`nano-banana-pro`	docs.createya.ai/models/nano-banana-pro
GPT Image 2	image	`gpt-image-2`	docs.createya.ai/models/gpt-image-2
GPT Image 2 Edit	image (i2i)	`gpt-image-2-edit`	docs.createya.ai/models/gpt-image-2-edit

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

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

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

code

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

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

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

code

Ты: Возьми эту картинку (URL) и оживи через Kling, 5 секунд
Агент: [вызывает createya:run_model с model=kling-video-o3, image_url=...]
       → возвращает run_id
       → через 30-60 сек: createya:get_run_status → готовое видео

examples/02-generate-video.md

REST без MCP

examples/05-rest-curl.md — curl (sync + async + upload)
examples/06-rest-python.md — Python client
examples/07-rest-nodejs.md — TypeScript / Node.js / Express / Next.js
examples/08-rest-go.md — Go (stdlib, без зависимостей)
examples/09-rest-php.md — PHP / Laravel / Symfony
examples/03-async-polling.md — async-задачи (видео) с exponential backoff
examples/04-upload-image.md — загрузка картинки для image-to-image
examples/10-error-handling.md — обработка всех ошибок, retry-pattern

📡 Без MCP — обычный REST API

Если ты не агент, а просто разработчик — есть REST API. Один Bearer-токен, один POST, готово.

Шаг 1 — получить токен

Зарегистрируйся на createya.ai (получишь 100 бесплатных кредитов)
Зайди в createya.ai/settings/api-keys
Create new key → дай ему имя (например my-bot-prod) → Create
Скопируй ключ — он показывается один раз. Формат: crya_sk_<32hex>
Храни как пароль (env var, secret manager, не в git)

Шаг 2 — первый запрос

bash

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": "кот на луне в стиле Studio Ghibli",
      "aspect_ratio": "16:9"
    }
  }'

Ответ:

json

{
  "run_id": "run_01HZX...",
  "status": "completed",
  "output": {
    "urls": ["https://cdn-new.createya.ai/image/profile-id/abc123.png"]
  }
}

Шаг 3 — Python / Node.js / Go

Python (с requests):

python

import os, requests

KEY = os.environ["CREATEYA_API_KEY"]
r = requests.post(
    "https://api.createya.ai/v1/run",
    headers={"Authorization": f"Bearer {KEY}"},
    json={"model": "nano-banana-2", "input": {"prompt": "кот на луне"}}
)
print(r.json()["output"]["urls"][0])

Node.js (нативный fetch, Node 18+):

javascript

const KEY = process.env.CREATEYA_API_KEY;
const r = await fetch("https://api.createya.ai/v1/run", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "nano-banana-2",
    input: { prompt: "кот на луне" }
  })
});
const json = await r.json();
console.log(json.output.urls[0]);

Go:

body := strings.NewReader(`{"model":"nano-banana-2","input":{"prompt":"кот на луне"}}`)
req, _ := http.NewRequest("POST", "https://api.createya.ai/v1/run", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("CREATEYA_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

→ Полные примеры: examples/05-rest-curl.md, examples/06-rest-python.md, examples/07-rest-nodejs.md

Async-задачи (видео, длинная музыка)

bash

# Шаг 1 — запуск
curl -X POST https://api.createya.ai/v1/run \
  -H "Authorization: Bearer crya_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"model":"kling-video-o3","input":{"image_url":"https://...","duration":5}}'
# → 202 Accepted, { "run_id": "run_01J2...", "status": "queued" }

# Шаг 2 — polling каждые 10 сек
curl https://api.createya.ai/v1/runs/run_01J2... \
  -H "Authorization: Bearer crya_sk_..."
# → { "status": "completed", "output": { "url": "https://cdn-new.createya.ai/video/..." } }

Все REST-эндпоинты

Метод	URL	Что делает
`GET`	`/v1/models`	Каталог всех моделей с `parameters_schema`
`POST`	`/v1/run`	Запустить генерацию
`GET`	`/v1/runs/{run_id}`	Статус async-задачи
`GET`	`/v1/balance`	Баланс кредитов workspace
`POST`	`/v1/uploads`	Загрузить картинку/видео в Createya CDN (для image-to-image)
`GET`	`/v1/openapi.json`	OpenAPI 3.1 спека (для автогенерации SDK)

Машиночитаемые спеки

OpenAPI 3.1: https://api.createya.ai/v1/openapi.json — для автогенерации Python/TypeScript/Java/Ruby SDK
llms.txt: https://api.createya.ai/llms.txt — карта API для AI-агентов
Полная документация: createya.ai/api

🏢 Для юридических лиц

Createya работает с компаниями по договору и безналу.

Безналичный расчёт — выставляем счёт, оплата с расчётного счёта компании
Договор + акт — закрывающие документы для бухгалтерии
НДС — счета с НДС или без, по запросу
Объёмные пакеты — оптовая скидка обсуждается индивидуально
API под нагрузку — повышенные rate limits, выделенные ключи на сервисы
152-ФЗ — все данные хранятся локально, полное соответствие закону «О персональных данных»
White-label — Telegram-бот / web под вашим брендом возможен

📩 Реквизиты и счёт за 1 рабочий день: support@createya.ai

🔐 Безопасность

API-ключи — формат crya_sk_<32hex>, хранятся хешированно (bcrypt)
Workspace isolation — ключ привязан к одному workspace, не может списать кредиты с другого
OAuth 2.1 + PKCE — для web-клиентов (Claude.ai)
Rate limits — на уровне ключа, защита от утечек
152-ФЗ — все данные хранятся локально

📚 Документация

Документ	Где
Quickstart REST	createya.ai/api/getting-started
Полная REST-спека	createya.ai/api/rest
MCP-коннектор	createya.ai/api/mcp
OpenAPI 3.1	api.createya.ai/v1/openapi.json
Каталог моделей	createya.ai/knowledge
Примеры в этом репо	`examples/`

💬 Связь

🌐 Сайт: createya.ai
📚 База знаний: createya.ai/knowledge
🤖 Telegram-бот (для генерации напрямую без кода): @createya_bot
📧 Поддержка: support@createya.ai
💼 Партнёрство / Амбассадорам: createya.ai/ambassador

🤝 Контрибьютим

PRs welcome — новый MCP-клиент конфиг, новый язык в примерах, фикс опечатки. См. CONTRIBUTING.md для guideline'ов.

Нашёл баг или хочешь модель — открой issue.

Уязвимость? Не открывай публичный issue — пиши на security@createya.ai. См. SECURITY.md.

📄 Лицензия

MIT — бери, форкай, делай свои интеграции. Только укажи нас как автора.

Createya — мир нейросетей без границ. Для AI-агентов всего мира.

⭐ Поставь звезду если репо помог!

</div>

Install

claude_desktop_config.json

{
  "mcpServers": {
    "createya-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.createya.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.