ForHosting KIT · 開発者向けツール

シード指定で再現可能なワードサーチ盤面を作成

文字を一つずつ手作業で並べることなく、指定した単語一覧から完成したワードサーチ盤面を作成できます。単語、正方形のサイズ、整数のシードを指定すると、各単語を縦・横・斜めに配置し、同じ文字で交差させ、残ったマスを再現可能な文字で埋めます。応答には完成した各行と正確な配置座標が含まれるため、印刷教材、自動テスト、授業資料、安定した問題と正解表を必要とするアプリケーションにご利用いただけます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

単語一覧を用意して盤面サイズを選択します

英字 A から Z だけで構成された、重複しない単語を1個から20個までご用意ください。大文字と小文字による違いはなく、受け付けた単語は配置前にすべて大文字へ統一されます。<code>grid_size</code> には正方形の行数と列数を2から25の範囲で指定します。最長の単語はこの値を超えられません。単語は曲がったり端から折り返したりせず直線上に並ぶため、6文字の単語には少なくとも6マスが必要です。大きな盤面では単語間の余白と埋め文字が増え、小さな盤面では交差が多くなる傾向があります。全単語が収まらない場合は、サイズを大きくするか一覧を短くしてください。大文字化後に同一となる単語は、正解表が曖昧になるため受け付けません。空白、ハイフン、アクセント付き文字、数字、記号も使用できず、各マスは必ず予測可能な英大文字1文字になります。

シードで配置と埋め文字を再現します

<code>seed</code> は、通常ならランダムに見えるすべての選択を制御します。生成処理では各単語について、東西南北と4方向の斜めを含む、盤面内に収まる全候補を列挙し、シード由来の疑似乱数列で順序を決めます。長い単語から処理し、ある配置が後続の単語を妨げた場合は、決定的なバックトラッキングで別候補へ戻ります。2つの単語が同じマスを共有できるのは、双方が同じ文字を必要とするときだけです。全単語の配置後、同じ疑似乱数列を使って空きマスを埋めます。したがって、同じ順序の同じ単語、同じサイズ、同じシードを指定すれば、盤面と配置情報は常に一致します。これは再現性のための仕組みであり、秘密保持や暗号学的な予測困難性を提供するものではありません。

盤面を読み取り正解表を作成します

応答の <code>grid</code> は、同じ長さの文字列を行ごとに並べた配列です。等幅フォントでそのまま表示するか、各文字列を1文字ずつ分割してマスを作成できます。<code>placements</code> の座標は0始まりで、<code>row: 0</code> と <code>column: 0</code> が左上です。<code>E</code> と <code>W</code> は横、<code>N</code> と <code>S</code> は縦、<code>NE</code>、<code>NW</code>、<code>SE</code>、<code>SW</code> は斜めを示します。内部では長い単語から探索しますが、配置情報は入力した単語一覧と同じ順序で返ります。利用者にはこの情報を隠して正解表として保存したり、対話型画面で正解した単語を強調したりできます。すべてを配置できない場合は、一部だけの盤面を返さず入力エラーになりますので、サイズを大きくするか単語数を減らしてください。

活用例

授業用プリントを作成

学習者向けに安定した問題を生成し、返された配置情報を別の正解表として保管できます。

対話型単語ゲームを開発

選択可能なマスを表示し、座標と方向を使って選択された各単語を検証できます。

再現可能なテストデータを準備

小さな単語一覧とシードだけを保存し、テスト実行時にまったく同じ盤面を再生成できます。

よくある質問

API の1回の料金はいくらですか？

API は1盤面につき $0.002 です。同じ生成処理をブラウザーでは無料で実行できます。

同じシードなら常に同じ問題になりますか？

はい。単語、その順序、盤面サイズ、シードがすべて同じであれば同一になります。

単語はどの方向に配置されますか？

横、縦、斜めのそれぞれ両方向に配置でき、合計8種類の方向コードがあります。

複数の単語で文字を共有できますか？

はい。そのマスで必要な文字が同じ場合に限り、単語同士を交差させられます。

単語が収まらない場合はどうなりますか？

部分的な盤面ではなく入力エラーを返します。盤面を大きくするか一覧を短くしてください。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/game/word-search-grid-generate

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/game/word-search-grid-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"words":["ORBIT","MOON","STAR"],"grid_size":8,"seed":42}'

const res = await fetch("https://api.kit.forhosting.com/game/word-search-grid-generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "words": [
      "ORBIT",
      "MOON",
      "STAR"
    ],
    "grid_size": 8,
    "seed": 42
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/game/word-search-grid-generate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "words": [
        "ORBIT",
        "MOON",
        "STAR"
    ],
    "grid_size": 8,
    "seed": 42
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/game/word-search-grid-generate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"words":["ORBIT","MOON","STAR"],"grid_size":8,"seed":42}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"words":["ORBIT","MOON","STAR"],"grid_size":8,"seed":42}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/game/word-search-grid-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "words": [
    "ORBIT",
    "MOON",
    "STAR"
  ],
  "grid_size": 8,
  "seed": 42
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "game.word_search_grid_generate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

`max_grid_size`	25
`max_words`	20

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →