create-api.dev by Kong
Kong Inc. · コーディング
create-api.dev は Kong の AI による OpenAPI 仕様ジェネレーターであり、Kong の OpenAPI ビルダーでもある。API を普通の言葉で説明すると、共有・テスト・出荷に使える仕様を数秒で下書きする。
create-api.dev by Kong について
What Is create-api.dev
create-api.dev は、Kong Gateway と Insomnia を手がける Kong の AI ツールだ。文章で書いた API の説明を、実用的な OpenAPI 仕様に変換する。OpenAPI は、エンドポイントやパラメーター、レスポンスがどう対応するかを各種ツールに伝える標準フォーマットである。YAML を手で書く必要はない。API が何をすべきかを説明すれば、ビルダーが仕様を下書きしてくれる。実際には、そのまま信頼する確定契約ではなく、手を入れられる AI が生成する API 仕様として使うものだ。
このツールは Kong Labs のプロジェクトとして提供される。つまり、完全なサポート対象の製品ではなく実験的なプレビューである。Kong はいつでも変更や停止ができ、可用性の約束も公式のサポート窓口もない。加えて Google の言語モデル上で動くため、入力したプロンプトと出力は外部の提供元を通る。
最大の制約は精度だ。AI が下書きした仕様は完全に見えても、誤ったフィールド型や抜けた境界条件、でっち上げの例が混じりうる。誰かがこれをもとに作る前に、行ごと見直すべき初稿として扱うのがいい。
Getting Started
- ブラウザーで create-api.dev を開き、セッションを始める。インストールも事前の登録フォームも要らない。
- API を普通の言葉で説明する。何をするのか、どのエンドポイントがあるのか、各エンドポイントが何を受け取り何を返すのかを書く。
- 説明を送り、そこから OpenAPI 仕様を下書きさせる。
- 結果を確認する。パス、メソッド、パラメーター、レスポンスの形をチェックし、続くメッセージで変更を頼む。
- 完成した仕様をエクスポートするかリポジトリにコピーし、Insomnia、Swagger UI、自前のパイプラインに読み込む。
AIツール情報
create-api.dev by Kongの料金、対応プラットフォーム、性能を簡単に確認できます。
こんな人におすすめ
このツールが最も力を発揮するユーザー、タスク、シーン。
ユーザー
- バックエンドとプラットフォームのエンジニア：コードを手で書く前に仕様の出発点を素早く得たい人向け。誤った型や抜けを見つける確認が要る。
- 個人開発者と小さなチーム：OpenAPI の YAML を手で保守したくないときに役立つ。すでに Insomnia など Kong のツールを使っていると相性がいい。
- テクニカルライターと API プロダクト担当：レビュー用に契約をざっと描く早い手段。確定ドキュメントではなく草稿として扱うのがよい。
タスク
- 粗いアイデアから OpenAPI 仕様を下書きする：エンドポイントを普通の言葉で説明すると、編集できる構造化された初版が得られる。
- 既存の仕様の抜けを埋める：足りないパスやレスポンスコードを、YAML を打たずに説明で追加する。
- コードが無いうちに試作する：早い段階で仕様を作り、クライアント側のチームやモックが定義済みの契約に沿って動けるようにする。
シーン
- 初期の設計レビュー：完全な実装を待たずに、企画会議で話せる具体物が手に入る。
- 新しいサービスの立ち上げ：仕様ファイルの白紙状態を避け、生成された構造から始められる。
- OpenAPI の構造を学ぶ：説明が実際の仕様フィールドにどう対応するかが見え、自分で書くときの助けになる。
主な機能
普通の言葉で仕様を生成する
日常の言葉で API を説明すると、ビルダーがそれを OpenAPI ドキュメントに変える。パス、メソッド、パラメーター、レスポンスのスキーマを埋める OpenAPI 仕様ジェネレーターとして働き、空の YAML を眺めずに済む。価値は速さにある。数秒の下書きは、空のファイルに勝る。
対話で反復的に仕上げる
仕様は一度で完成しない。会話を続け、おかしい点を指摘し、変更を求める。各ラウンドでドキュメントが更新され、最初の答えで固まることなく、本当に意図した形へ近づいていく。
共有とテストにそのまま使える出力
出力は標準の OpenAPI 仕様として出てくる。ほとんどの API ツールがすでに読む形式だ。変換なしで Insomnia や Swagger UI、CI のチェック工程に置ける。Kong は共有・テスト・出荷に使えるとうたっており、形式がそれを裏づける。
Kong の API ツールの上に構築
Kong Gateway と Insomnia のチームから出ており、よくある開発の流れになじむ。Insomnia を設計やモックにすでに使っているなら、生成された仕様を追加設定なしで組み込める。
メリットとデメリット
メリット
- 短い説明を素早く構造化された OpenAPI 仕様に変え、新しい API の白紙状態を解消する。
- 出力は標準の OpenAPI 形式なので、Insomnia、Swagger UI、その他の一般的なツールで使える。
- すでに Kong と Insomnia で動くチームには自然になじむ。
- 導入の壁がない。ブラウザーで開けば、すぐに API を説明し始められる。
デメリット
- Kong Labs の実験プロジェクトなので、Kong はいつでも変更や終了ができ、サポートの約束もない。
- AI が下書きした仕様は誤ったフィールド型や抜けた境界条件、でっち上げの例を含みうるため、使う前にどの出力も丁寧な確認が要る。
- プロンプトと生成された仕様は Google の言語モデルを通る。API の詳細が機微な場合はここが気になる。
よくある質問
Kong の AI ツールで、API の普通の言葉による説明から OpenAPI 仕様を下書きする。Kong の OpenAPI ビルダーとして、説明を伝えると確認・編集・エクスポートできる仕様を用意する。手で打つ代わりに AI で OpenAPI を生成する手段だ。
関連コンテンツ
create-api.dev by Kongに関連するツール、スキル、記事を探す。
create-api.dev by Kongの代替ツール
Forefront
Forefront · コーディングForefrontはオープンソースAIで構築するためのウェブプラットフォームだ。主要なオープンソース言語モデルを自分のデータで微調整し、性能を評価し、API経由で実行したり、エクスポートして自分でホストしたりできる。クローズドなプラットフォームの手軽さを求めつつ、モデルとデータの所有権にはこだわる開発者が対象だ。
Startkit
StartKit.AI · コーディングStartkitは、AI SaaSとAIラッパー製品を作るためのボイラープレートだ。面倒な部分をあらかじめ配線済みにしたAIスタートアップボイラープレートと考えればいい。認証、StripeとLemon Squeezyの決済、利用制限、トランザクションメール、そしてOpenAI、Anthropic、Groq、Llamaと通信するAI APIスターターキットが含まれる。リポジトリをクローンして価格を設定し、ユーザーが実際にお金を払う部分に取りかかれる。ReactとTailwind上のNext.jsで作られているため、ボイラープレートコードの多くはすでに見慣れたものだ。
Testim
Tricentis · コーディングTestimは、Web・モバイル・Salesforceアプリ向けにエンドツーエンドテストを構築して実行するAIテスト自動化プラットフォームだ。機械学習を頼りに、インターフェースが変わってもテストを安定させ、チームが壊れたセレクターの修正に費やす時間を減らす。今日から使い始められる自動テストツールとしては悪くない。ブラウザで操作を録画してテストを作り、より細かい制御が必要なときはJavaScriptを足す。忙しいQAチームにとって堅実な選択肢である。