Createya — AI Image & Video Generation

---

🎯 これが必要な理由

AI エージェントの時代が到来しました。Claude、Cursor、Cline、OpenCode、Codex など、毎週のように新しいエージェントフレームワークが登場しています。これらはすべて、外部ツールを接続する Anthropic のオープン標準である MCP（Model Context Protocol）を使用します。

Createya は、よくある 4 つの問題を解決します：

問題	Createya の解決策
地域制限があり、VPN が必要	VPN 不要で直接アクセス可能
海外のカードが使えない	ロシアのカード、SBP、T-Pay に対応。ルーブルでお支払いいただけます
サービスごとに異なるキーが必要	1 つの API キーでモデルカタログを利用
データのローカル保存（152-FZ）	すべてのデータをローカルに保存し、法律に完全準拠
法人および B2B	契約書、請求書、受領書をご用意。VAT 込みの銀行振込に対応

これらすべてを MCP（エージェント向け）または通常の REST（ご自身のコード向け）経由で利用できます。

---

⚡ 60 秒で始める

1. 登録して、無料の 100 クレジットを受け取る createya.ai

2. API キーを作成する（形式：crya_sk_<32hex>） createya.ai/settings/api-keys

3. 次に、利用方法を選びます：

🤖 AI エージェントを開発する場合 → 1 つのコマンド

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

実行 1 回で MCP サーバーとスキルをインストールします。自動検出に対応：Claude Code（~/.claude/skills/）、opencode（同じパスを読み込み）、Codex CLI / Cursor / OpenClaw（agentskills.io の標準に準拠した汎用パス ~/.agents/skills/）。

リポジトリ内のすべてのスキルが自動的にインストールされます。新しいスキルを追加すると、次回の 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 つのツールを利用できるようになります：

ツール	説明
🔍 list_models	parameters_schema を含む、すべてのモデルのカタログです。エージェントは呼び出し可能なモデルを自動で確認します。
🎨 run_model	生成を実行します：{ model: <slug または family>, input: {...} }。画像／動画／音声／テキストに対応します。
⏳ get_run_status	非同期タスクのステータスを確認します（動画の生成には通常 30～180 秒かかります）。
💰 get_balance	ワークスペースの現在のクレジット残高を確認します。

エンドポイント： 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 → 設定 → コネクター → カスタムコネクターを追加 Claude Desktop → + メニュー → Connectors → Add custom connector
2. サーバー URL：https://api.createya.ai/mcp
3. Claude が Createya の認証ページを開きます。自分の crya_sk_... キーを貼り付けて → 許可
4. 完了です。チャットにツール（list_models、run_model など）が表示されます。

💡 チームの参加者ごとに自分のキーを用意してください。クレジットは、キーが紐づいているワークスペースから差し引かれます。

B. Claude Code（CLI）

1 つのスクリプトで、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 プラグイン — プラグインは plugins/createya-mcp/ にあります。Codex Plugins UI に Createya のカード、ロゴ、MCP サーバー、リポジトリ内のすべての Createya スキルを追加します。詳しい手順は docs/codex-plugin.md をご覧ください。

ルートにある skills/ が信頼できる唯一の情報源です。スキルまたはアセットを編集した後は、プラグインパッケージを更新してください：

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/ にあります（ライブ API と週 1 回同期）。

現在、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

近日公開予定（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 など。

📚 API 経由のライブカタログ：GET https://api.createya.ai/v1/models（公開、認証不要） 📖 モデルのマーケティング概要：createya.ai/knowledge 📡 API ドキュメントとモデルごとのページ：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

MCP を使わない REST

• examples/05-rest-curl.md — curl（同期＋非同期＋アップロード）
• examples/06-rest-python.md — Python クライアント
• examples/07-rest-nodejs.md — TypeScript / Node.js / Express / Next.js
• examples/08-rest-go.md — Go（標準ライブラリ、依存関係なし）
• examples/09-rest-php.md — PHP / Laravel / Symfony
• examples/03-async-polling.md — exponential backoff による非同期タスク（動画）
• examples/04-upload-image.md — image-to-image 用の画像アップロード
• examples/10-error-handling.md — すべてのエラー処理、リトライパターン

---

📡 MCP を使わない通常の REST API

エージェントではなく、単に開発者として利用する場合は REST API があります。Bearer トークンを 1 つ用意し、POST を 1 回送信すれば完了です。

ステップ 1 — トークンを取得する

1. createya.ai に登録します（無料クレジットを 100 クレジット受け取れます）
2. createya.ai/settings/api-keys にアクセスします
3. Create new key → 名前を付けます（例：my-bot-prod）→ Create
4. キーをコピーします — 表示されるのは一度だけです。形式：crya_sk_<32hex>
5. パスワードとして保管します（環境変数、シークレットマネージャーを使用し、git には保存しないでください）

ステップ 2 — 最初のリクエスト

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"
    }
  }'

レスポンス：

{
  "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 を使用）：

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+）：

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 をご覧ください。

非同期タスク（動画、長時間の音楽）

# Шаг 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}	非同期タスクのステータス
GET	/v1/balance	ワークスペースのクレジット残高
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 — AI エージェント向け API マップ
• 完全なドキュメント：createya.ai/api

---

🏢 法人のお客様向け

Createya は契約および銀行振込による法人利用に対応しています。

• 銀行振込 — 請求書を発行し、会社の銀行口座からお支払いいただけます
• 契約書＋検収書 — 経理用の書類を発行します
• VAT — ご要望に応じて、VAT 込みまたは VAT 抜きの請求書を発行します
• 大容量パッケージ — ボリューム割引は個別にご相談いただけます
• 高負荷向け API — レート制限の引き上げ、サービス専用キー
• 152-ФЗ — すべてのデータを国内に保存し、「個人データに関する法律」に完全準拠しています
• ホワイトラベル — お客様のブランドで Telegram ボット／Web を提供できます

📩 会社情報と請求書は 1 営業日以内にお送りします：[email protected]

---

🔐 セキュリティ

• API キー — 形式は crya_sk_<32hex> で、ハッシュ化して保存されます（bcrypt）
• ワークスペース分離 — キーは 1 つのワークスペースに紐付けられ、別のワークスペースのクレジットを消費できません
• OAuth 2.1 + PKCE — Web クライアント向け（Claude.ai）
• レート制限 — キー単位で適用し、漏えいを防止します
• 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
• 📧 Поддержка: [email protected]
• 💼 Партнёрство / Амбассадорам: createya.ai/ambassador

---

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

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

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

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

---

📄 Лицензия

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

---