Genspark AI Agent Builder API Custom：アクセス、料金、統合、プロダクションガイド
最終確認日: 2026年10月21日
対象: Genspark Custom Agentsを本番アプリケーションに組み込めるかを判断するインディーハッカーおよびAIプロダクトチーム
Genspark AI Agent Builder API Customを検索した場合、見落としやすい重要な違いがあります。GensparkはCustom Agentを、独自のバックエンドからエージェントを作成・呼び出しするための文書化されたRESTまたはSDKのインターフェースではなく、プロダクト内のノーコードエージェントビルダーとして説明しています。公開されているCustom Agentガイドは、チャットまたは@メンションを介してGenspark内でエージェントを作成、テスト、更新、共有、呼び出しすることに焦点を当てています。GensparkのCustom Agentドキュメントが、このプロダクト領域に関する信頼できる情報源です。
これは、Custom Agentが実務に不向きであるという意味ではありません。人がGensparkを作業インターフェースとして使用する場合、社内チームが再利用可能な専門エージェントを必要とする場合、またはGenspark Workflowで定期タスクをオーケストレーションする場合には適しています。一方、顧客向けアプリケーションに安定した文書化済みエンドポイント、独自の認証境界、決定論的なリクエスト／レスポンス処理、サービスレベルの運用が必要な場合には、これを前提にするのは誤りです。
このガイドでは、この2つの経路を分け、現在Gensparkが公開しているドキュメントの内容を説明し、外部APIが実際の要件である場合の本番パターンを提示します。
Genspark AI Agent Builder API Custom：簡潔な回答
| 必要なもの | 最も文書化されているGensparkの経路 | リリース前に確認すべきこと |
|---|---|---|
| Gensparkで作業する人向けの、再利用可能なノーコード専門エージェント | Custom Agentを作成し、Previewでテストしてから、非公開、リンク、組織、またはCustom Agent Storeを通じて共有します。 | 指示、共有範囲、出力レビュー、および利用を許可される人。 |
| 定期的な社内自動化 | Workflowを構築し、シミュレーションデータでテストしてから有効化します。Gensparkはスケジュールおよびメールトリガーを文書化しています。 | 接続アカウントの権限、不可逆な操作、実行履歴、および人による承認ポイント。 |
| Gensparkワークスペース内の接続システム | 利用可能な場合はネイティブコネクタまたはMCP接続を使用します。 | OAuth/APIキーのスコープ、読み取りと書き込みの挙動、テナントポリシー、および非重要レコードに対するテスト。 |
| コーディングエージェントのワークフロー | 文書化されたワークスペースまたはCLIフローを通じてGenCodeを使用します。 | アカウント／クレジットの所有権とライブモデルカタログ。 |
| アプリが呼び出す顧客向けAPI | Gensparkから最新の書面によるAPIドキュメントと契約上のアクセスが提供されない限り、これをCustom Agent APIではなく外部サービス統合として扱います。 | エンドポイント契約、認証、レート制限、利用量計測、データ処理、リトライ、およびサポート／SLA条件。 |
公開されているドキュメントと、公開されていないもの
現在のCustom Agentガイドでは、Custom Agent Storeでエージェントを作成し、その役割、機能、出力基準を定義してPreviewでテストし、更新して、@を用いてSuper Agent内で呼び出す手順が説明されています。また、共有コントロールも文書化されています。一方、外部アプリケーションからCustom Agentをプログラムで作成または呼び出すための公開RESTエンドポイント、SDKメソッド、APIキー認証フロー、APIリファレンスは公開されていません。プロダクト設計でこれに依存する前に、Custom Agentガイドを確認してください。
Gensparkは別の領域向けに、APIキーに関連する設定を文書化しています。GenCode CLIでは、GSK_API_KEYまたはGSK_BASE_URLに関連付けられたアカウントに利用料金を請求できます。これはCustom Agent APIのドキュメントではないため、これを根拠に文書化されていないエンドポイントや自動化契約を推測しないでください。GenCodeの公式ガイドでは、このCLIの文脈が明示されています。
したがって、Genspark AI Agent Builder API Customという表現は、公開APIプロダクト名を指すというよりも、意思決定上の問題をより正確に表しています。Gensparkの営業またはサポート担当者がプライベート、エンタープライズ、ベータ、パートナー向けインターフェースを提供する場合は、本番依存先として扱う前に、最新のAPIリファレンス、許容利用条件、データ処理条件、制限、サポートコミットメントを書面で求めてください。
プランを選ぶ前に統合形態を選ぶ
まず、制御する必要がある境界から始めます。
経路A：作業をGenspark内に留める
出力先が、すでにGensparkで作業している個人またはチームである場合は、この経路を選択してください。
- 狭い役割、明示的な入力、出力形式、行動上の境界を備えたCustom Agentを作成します。
- 共有する前に、Previewで代表的なケースをテストします。
- エージェントに必要なシステムだけを接続します。Gensparkのコネクタガイドは、ネイティブAPI呼び出しとMCPツールを区別し、可用性はアカウント、組織設定、プロバイダー要件に依存すると説明しています。
- 定期作業では、Workflowを作成し、ライブ実行を有効にする前にシミュレーションテストを実行します。
- 実行履歴を確認し、出力またはアクションが安全でない場合はワークフローを無効にします。
これは生産性の高いローコード運用モデルです。自社プロダクト内のAPIの背後にGensparkエージェントを埋め込むこととは同じではありません。
経路B：外部アプリケーションサービスを構築する
Genspark UI上の人ではなく、ソフトウェアがエージェント機能を呼び出す必要がある場合は、この経路を選択してください。エージェントワークフローを自社で所有するサービスにします。
Your app → your API → auth + policy → queue/worker → model gateway → model provider
↘ audit log + evaluation + retry policy
この境界により、チームは入力検証、テナント分離、コスト上限、レスポンススキーマ、タイムアウトポリシー、可観測性を制御できます。また、顧客向け契約を書き換えることなく、モデルまたはゲートウェイを置き換えることも可能になります。
マルチモデルアプリケーションでは、OpenAI互換ゲートウェイにより、モデル選択を設定に保持しながらクライアント統合を安定させられます。FlatkeyのAPIクイックスタートでは、https://router.flatkey.ai/v1のベースURLと、使い慣れたOpenAI SDKの形式が文書化されています。また、統合AI APIガイドでは、最初のリクエスト、使用量の検証、その後の制御されたルーティングという導入パターンを説明しています。
以下は最小限のNode.jsサーバーサイド呼び出しです。これはGenspark Custom Agentへの呼び出しではありません。開発者が制御する外部モデルサービスの例です。
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: "https://router.flatkey.ai/v1",
});
export async function draftAccountSummary(accountNotes) {
const response = await client.chat.completions.create({
model: process.env.SUMMARY_MODEL,
temperature: 0,
messages: [
{
role: "system",
content: "Return JSON with risks, next_actions, and evidence. Do not invent facts.",
},
{ role: "user", content: accountNotes },
],
response_format: { type: "json_object" },
});
return JSON.parse(response.choices[0].message.content);
}
プロバイダーキーをブラウザーコードに配置しないでください。呼び出しはサーバーの背後に置き、ユーザーとテナントのIDを自社の監査記録に紐付け、プロダクトが約束するレスポンス契約だけを公開してください。
経路C：Gensparkを実行時APIではなく運用ワークスペースとして使用する
両方を必要とするチームもあります。Gensparkはリサーチ、社内実行、ドキュメント作成、または担当者が関与するワークフローに使用し、顧客向けアプリケーションリクエストは自社所有のサービスで処理します。引き渡しは、文書化されていないプログラム接続ではなく、人による承認（たとえばGensparkからエクスポートされたレビュー済みレポート）にできます。
これにより、アプリケーションがブラウザーワークフローやコンシューマー向けUIを公開APIのように振る舞わせる脆弱な設計を回避できます。
Gensparkのアクセスと料金：公開プランで実際に示されている内容
Gensparkの料金モデルはクレジットおよびメンバーシップベースです。公開プランページでは、以下の特典と価格は2027年6月30日まで有効とされています。クレジット、機能の利用資格、地域税は変更される可能性があるため、購入前に最新のメンバーシッププランページを確認してください。
| プラン | 公開価格（USD） | 公開クレジット割り当て | Custom Agent評価における実践的な解釈 |
|---|---|---|---|
| Free | $0 | 生涯利用枠の対象となる、1日100クレジット | 小規模なハンズオンの概念実証に有用です。モデルおよびエージェントへのアクセスは制限されます。 |
| Plus | 月額$24.99、または年払いで月額$19.99 | 月10,000クレジットから | 利用者がエージェントを作成・反復改善する場合の、妥当な個人向け評価ティアです。 |
| Pro | 月額$249.99、または年払いで月額$199.99 | 月125,000クレジットから | より負荷の高い個人利用および大規模ワークロード向けです。 |
| Team | 月額$40/シート、または年払いで月額$35/シート | 月10,000クレジット／シート | 一元管理、請求、利用状況分析、コネクタ管理が追加されます。 |
| Enterprise | カスタム | プーリングおよびガバナンス機能付きで、月20,000クレジット／シートと記載 | ガバナンス、SAML/SCIM、商用条件、またはベンダーサポート付き統合経路が必要な場合に適した選択肢です。 |
これらはプラン価格であり、Custom Agent APIに関する公開済みのリクエスト単価ではありません。言い換えると、Genspark AI Agent Builder API Customの料金についての現時点での回答は次のとおりです。文書化されているプロダクト領域で使用するGensparkのプランとクレジットを予算化してください。別途文書化されたCustom Agentエンドポイントが存在するかのように、アプリケーションのユニットエコノミクスをモデル化してはいけません。
また、「無料枠」とクレジットは別物として扱ってください。Gensparkによれば、週次のFree Quotaは指定されたエージェントプロダクトのStandardモードタスクに適用され、その枠を使い切った後もクレジットに裏付けられた利用は継続します。本番計画では、サブスクリプション価格だけから予測するのではなく、実際に使用する予定のモデルとモードで代表的なワークフローを測定してください。
どちらの経路にも共通する本番チェックリスト
接続データを読み取る、またはアクションを実行できるエージェントを有効にする前に、このチェックリストを完了してください。これはCustom Agent + Workflowにも外部APIにも同様に重要です。
| 領域 | 本番運用の最低基準 |
|---|---|
| スコープ | 1つのジョブ、文書化された入力、文書化された出力スキーマ、および明示的な「してはいけないこと」リスト。 |
| ID管理 | 開発、ステージング、本番で認証情報を分離する。個人用コネクタまたはAPIキーを環境間で共有しない。 |
| 権限 | 可能な限り最小権限を付与し、書き込みアクションを許可する前に読み取り専用テストを実行する。OAuthとMCPのスコープは別々にレビューする。 |
| データ | 入力を分類し、シークレット／PIIを許可するか決定し、規制対象データを処理する前に適用される保存期間およびDPA条件をベンダーから入手する。 |
| 安全性 | メッセージ、チケット、レコード、支払いなどの外部副作用の前に確認を要求する。可能な場合は操作を冪等にする。 |
| 評価 | 通常、エッジ、危険なケースを含む小規模でバージョン管理されたテストセットを構築する。プロンプトやモデルを変更する前に合格／不合格基準を定義する。 |
| 信頼性 | 上限のあるタイムアウト、明示的なリトライルール、人によるエスカレーション経路を設定する。副作用を伴う作業で無制限の自動リトライを使用しない。 |
| 可観測性 | シークレットや不要なセンシティブなプロンプト内容を保存せずに、リクエストID、ワークフロー／エージェントのバージョン、モデルルート、レイテンシ、結果、コストを記録する。 |
| 変更管理 | 指示と設定をバージョン管理する。変更をPreview／テストし、その後に広範な有効化の前に小規模ロールアウトを行う。 |
| 退出計画 | 保持を許可されている指示、テストケース、実行記録をエクスポートし、ワークフローを停止または置き換える方法を文書化する。 |
Gensparkのコネクタガイドでは、既知の読み取りタスクから開始し、送信／作成／更新の権限を個別に検証するよう特に推奨しています。Workflowガイドでは、シミュレーションのTest Runとライブ実行を区別しています。これらは有用な最初のガードレールですが、機能を有効化する運用上の判断は依然として組織に委ねられます。
実践的な30分の評価計画
プロダクト全体を二度構築しなくても、方向性を選ぶのに十分なことを学べます。
- 1ページのジョブ定義を書く。ユーザー、入力ソース、期待出力、副作用、成功指標、許容できない失敗を明記します。
- Custom Agentを1つ構築する。Gensparkが推奨する役割／機能／出力境界の構造を使用します。Previewで現実的なプロンプトを5件テストします。
- 非重要なソースを1つ接続する。コネクタでそのオプションが提供されている場合は、読み取り専用から始めます。既知のレコードに対して出力を確認します。
- ワークフロー境界をテストする。スケジュールまたはメールトリガーによる作業が必要な場合は、シミュレーションWorkflowテストを実行します。まだ外部書き込みを有効化しないでください。
- アプリにAPIが必要な場合は外部サービステストを実行する。自社で制御する小さなエンドポイントを作成し、固定プロンプトを文書化されたモデルAPI経由で送信し、JSONレスポンスを返して結果をログに記録します。
- 応答品質だけでなく運用コストを比較する。レビュー時間、データアクセス、リトライ挙動、監査証跡、モデル支出、失敗処理を含めます。
最後に、機能比較ではなくアーキテクチャ上の選択を行います。
- 人がGensparkにとどまり、組み込みワークフローで十分な場合はCustom Agentを使用します。
- プロダクトまたはバックエンドが機能を呼び出す必要がある場合は、文書化されたAPIサービスを使用します。
- 引き渡しが意図的で、文書化され、安全である場合にのみ両方を使用します。
よくある統合の誤り
APIキーを公開プロダクトAPIの証拠として扱う
GenCodeドキュメントにおけるGSK_API_KEYの参照には、明確に定義されたCLIおよび請求の文脈があります。プロダクト内に表示されるAPIキーは、それ自体ではブラウザーリクエストのリバースエンジニアリングや、プライベートルートの本番利用を許可するものではありません。必要な正確な機能について、公式エンドポイントドキュメントと利用条件を求めてください。
サービス契約が必要なのにUIを自動化する
ブラウザーまたはセッションの自動化はデモでは機能するかもしれませんが、UIの挙動、アカウントセッション、不正利用防止コントロール、文書化されていないリクエスト形式への運用上の依存を生みます。これはサポートされたAPIの代替にはなりません。
コネクタを万能なデータパイプとして扱う
コネクタとMCPツールには、それぞれ独自の認可、ツールセット、組織ルール、下流プロバイダーの制約があります。特に書き込みや他者に影響するアクションについては、依存するすべてのアクションを検証してください。
コストと品質のベースラインを省略する
エージェントは単一のプロンプトでは印象的に見えます。本番の意思決定には、反復可能なタスクセット、測定された受け入れ率、失敗例、p95レイテンシ、レビュー時間、コスト上限が必要です。
FAQ
GensparkにはGenspark AI Agent Builder API Customエンドポイントがありますか？
2026年10月21日に確認した公開ドキュメントには、Genspark Custom Agentsを外部から作成または呼び出すための公開エンドポイントやSDKは記載されていません。プロダクト内での作成、Previewテスト、共有、@による呼び出しは文書化されています。契約済みまたはベータアクセスが必要な場合はGensparkに直接問い合わせてください。Custom Agent UIまたはGenCodeキーのドキュメントからエンドポイントを推測しないでください。
Custom Agentを他のツールに接続できますか？
はい、文書化されているプロダクト領域の範囲内で可能です。GensparkはネイティブコネクタとMCP接続について説明しており、Workflowsでは記載されたツールとともにCustom Agentsを使用できます。接続の可用性と権限は、アカウント、組織設定、外部プロバイダーに依存します。
Genspark Workflowは自分のアプリのWebhookを呼び出せますか？
公開Workflowガイドからそうだと想定しないでください。このガイドで文書化されているのは、スケジュールおよびメールトリガーと、サポートされる統合です。Webhookを本番ワークフローの一部にする前に、最新のGensparkドキュメントまたはサポートで、正確なトリガー、アクション、認証方式、ペイロードを確認してください。
GensparkのCustom Agentsは無料ですか？
Gensparkは、日次クレジットと限定的なモデル／エージェントアクセスを備えたFreeプランに加え、有料のPlus、Pro、Team、Enterpriseプランを公開しています。特定のエージェント、モデル、コネクタ、組織向けコントロールが利用できるかは、プランと現在のアカウント設定に依存します。
アプリ用のマルチモデルAPIが必要な場合、何を使うべきですか？
サーバーサイド認証と明示的なモデルルーティングポリシーを備えた、文書化済みのAPIを使用してください。サポート対象モデル全体でOpenAI互換の統合インターフェースを1つにしたい場合は、Flatkey APIクイックスタートから始め、その後、フォールバックルーティングと環境ごとの利用状況追跡を含む制御されたロールアウトに従ってください。
結論
Genspark AI Agent Builder API Customへの最善の答えは、UI優先のエージェントビルダーを文書化されていないAPIの役割に無理に押し込まないことです。Genspark Custom Agentは、文書化されているプロダクト内作成、コラボレーション、コネクタ、ワークフローの経路に使用してください。アプリケーションが呼び出し可能なバックエンド機能を必要とする場合は、サービス境界を自社で所有し、本番トラフィックに必要なセキュリティ、評価、コスト管理、可観測性を備えた文書化済みAPI統合を使用してください。
