Createya — AI Image & Video Generation

io.github.Createya-aiPublished by GitHub account Createya-aiv1.0.0Updated Oct 25, 2026

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

VerifiedStreamable HTTPWeb executableMedia & DesignAI & ML

Overview

AI-generated overview

Remote Createya MCP server that lets an assistant browse AI image and video models, run generations, poll async jobs and check credit balance.

What you can do
List the available generation models with their parameter schemas, so the assistant knows what it can call and how to call it (list_models). Start an image, video, audio or text generation by model slug or family with an input object (run_model). Poll the status of asynchronous jobs, such as video runs that typically take 30 to 180 seconds (get_run_status). Check the remaining credit balance of the workspace the key belongs to (get_balance).
When to use it
Useful when you want an AI agent to generate images or videos through Createya's hosted models without writing REST code, for example producing a picture from a prompt or animating an existing image URL. The README notes only a handful of image models are publicly available so far, with more listed as coming soon.
Requirements
A remote Streamable HTTP endpoint; no local package. A Createya account and an API key in the Authorization header as a Bearer token, or OAuth 2.1 sign-in for Claude clients. Credits are consumed per generation; 100 free credits are offered at sign-up. Network access to the Createya API is required.
Before you install
Generations spend workspace credits, and the balance tool exposes that balance. The API key is shown only once and should be stored like a password; anyone with it can spend the workspace's credits. The README's one-line install script pipes a remote script into bash with the key as an argument, which runs third-party code on your machine. Prompts and input images are sent to Createya's servers.

Installation

In SourceWeft

  1. Open Createya — AI Image & Video Generation in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Createya-ai%2Fcreateya-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "createya-ai-image-video-generation": {
      "type": "http",
      "url": "https://api.createya.ai/mcp"
    }
  }
}

README

[Createya]

Createya MCP & API

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

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

[MCP] [REST] [License: MIT] [No VPN] [Models]

🚀 Быстрый старт · 🤖 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 типичные проблемы:

ПроблемаРешение 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)

  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 и скиллы сразу:

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:

  1. Открой Codex → Plugins → Add marketplace.
  2. В поле Источник вставь Createya-ai/Createya-mcp.
  3. Git ref не меняй.
  4. Выборочные пути оставь пустым.
  5. Нажми 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 2imagenano-banana-2docs.createya.ai/models/nano-banana-2
Nano Banana 2 Editimage (i2i)nano-banana-2-editdocs.createya.ai/models/nano-banana-2-edit
Nano Banana Proimagenano-banana-prodocs.createya.ai/models/nano-banana-pro
GPT Image 2imagegpt-image-2docs.createya.ai/models/gpt-image-2
GPT Image 2 Editimage (i2i)gpt-image-2-editdocs.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

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

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

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

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

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

Ты: Возьми эту картинку (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

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

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

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

  1. Зарегистрируйся на createya.ai (получишь 100 бесплатных кредитов)
  2. Зайди в createya.ai/settings/api-keys
  3. Create new key → дай ему имя (например my-bot-prod) → Create
  4. Скопируй ключ — он показывается один раз. Формат: crya_sk_<32hex>
  5. Храни как пароль (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:

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.jsonOpenAPI 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 рабочий день: [email protected]

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

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

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

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

💬 Связь

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

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

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

Уязвимость? Не открывай публичный issue — пиши на [email protected]. См. SECURITY.md.

📄 Лицензия

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

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

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

Source: README.md at commit 05bc7d8

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts