by takawasi

1 APIキー管理

キーを発行してください
APIキーは他人に共有しないでください。漏洩した場合は再発行してください。再発行すると旧キーは即時無効になります。

2 サービス別APIドキュメント

SI 利用可能 AIコード生成
BASE URL https://si.takawasi-social.com
メソッド パス 説明
POST /run コード生成を開始
GET /status 実行状態を確認
GET /wave_order モジュール一覧
POST /turns/{module}/correct 修正指示
GET /files 生成物一覧
POST /run/stop 実行停止
NovelForge 利用可能 AI小説執筆エンジン
BASE URL https://novelforge.takawasi-social.com

APIドキュメント準備中。現在はWeb UIからご利用ください。

3 MCP設定(Claude Code連携)

Claude CodeからSIを直接操作できます。
以下の設定を.mcp.jsonに追加すると、Claude Codeのチャット画面からコード生成・状態確認・修正指示をそのまま実行できます。

.mcp.json 設定例

{
  "efsc": {
    "command": "python3",
    "args": ["/path/to/mcp_server.py"],
    "env": {
      "SI_URL": "https://si.takawasi-social.com",
      "SI_API_KEY": "sk-user-あなたのAPIキー"
    }
  }
}

MCPツール一覧

ツール 説明
efsc_run コード生成を開始
efsc_status 実行状態を確認
efsc_modules モジュール一覧
efsc_correct 修正指示
efsc_files 生成物一覧
efsc_file_content ファイル内容取得
efsc_stop 実行停止
efsc_logs ログ取得

4 コード例

# コード生成を開始
curl -X POST https://si.takawasi-social.com/api/run \
  -H "X-User-Key: sk-user-あなたのAPIキー" \
  -H "Content-Type: application/json" \
  -d '{"goal_spec": "ToDoアプリを作って", "mode": "auto", "model_preset": "DEEPSEEK"}'

# 状態確認
curl "https://si.takawasi-social.com/status?user_id=your_user_id" \
  -H "X-User-Key: sk-user-あなたのAPIキー"

# 生成物一覧
curl "https://si.takawasi-social.com/files" \
  -H "X-User-Key: sk-user-あなたのAPIキー"

# 実行停止
curl -X POST https://si.takawasi-social.com/api/run/stop \
  -H "X-User-Key: sk-user-あなたのAPIキー"
import requests

API_KEY = "sk-user-あなたのAPIキー"
BASE = "https://si.takawasi-social.com"
headers = {"X-User-Key": API_KEY}

# コード生成を開始
r = requests.post(f"{BASE}/run", headers=headers, json={
    "goal_spec": "ToDoアプリを作って",
    "mode": "auto",
    "model_preset": "DEEPSEEK",
})
print(r.json())

# 状態確認
r = requests.get(f"{BASE}/status", headers=headers)
print(r.json())

# 生成物一覧
r = requests.get(f"{BASE}/files", headers=headers)
print(r.json())

# 修正指示
r = requests.post(f"{BASE}/turns/module_name/correct", headers=headers, json={
    "instruction": "エラーハンドリングを追加してください",
    "target_dir": "/path/to/project",
})
print(r.json())
const API_KEY = "sk-user-あなたのAPIキー";
const BASE = "https://si.takawasi-social.com";
const headers = {
  "X-User-Key": API_KEY,
  "Content-Type": "application/json",
};

// コード生成を開始
const runRes = await fetch(`${BASE}/run`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    goal_spec: "ToDoアプリを作って",
    mode: "auto",
    model_preset: "DEEPSEEK",
  }),
});
console.log(await runRes.json());

// 状態確認
const statusRes = await fetch(`${BASE}/status`, { headers });
console.log(await statusRes.json());

// 生成物一覧
const filesRes = await fetch(`${BASE}/files`, { headers });
console.log(await filesRes.json());

// 実行停止
const stopRes = await fetch(`${BASE}/run/stop`, { method: "POST", headers });
console.log(await stopRes.json());

5 課金について

利用経路
API・Web UI — 同一課金
停止条件
残高0 → 次のWaveで停止
現在の残高