get_capabilities があります。認証情報に許可されたツールのみ表示され、呼び出しごとに権限と所有者が確認されます。クイックスタートから始めてください。
get_capabilities 以外では、以下のフィールドを arguments.input に入れます。書き込みには空白を含まない印字可能 ASCII 1～191 文字の arguments.idempotencyKey も必要です。既定値のある項目は省略できます。page_size と pageSize を混同しないでください。接続先の tools/list スキーマに従います。
成功結果は structuredContent と content の JSON テキストで返ります。初回は下記の形式です。再送時は replayed: true と識別子を含む小さな receipt を返し、完全な結果やキーの秘密値は返しません。
execution_pending（409）は初回の結果待ちです。execution_unknown（409）または status: unknown は、操作がすでに行われた可能性を示します。get_execution と対象タスク・注文・操作を確認します。新しいキーでこれらの状態を回避しないでください。 MCP 実行完了でも、モデルタスクやサイト確認は保留中の場合があります。
モデル結果の収集上限は 8 MiB・300 秒です。中断または上限超過時は、判明している request_id が実行記録に残ります。まず get_execution と既存のリクエスト・タスクを確認し、未解決の呼び出しを新たな有料リクエストや新規冪等キーで置き換えないでください。クライアントの切断は、受理済みモデルタスクのキャンセルを意味しません。
get_capabilities
読み取り · arguments: {}
接続初期化後、get_capabilities を {} で呼び出し、tools/list を確認します。audience: user、ownership: self、許可された scopes とツール、oauth: false が返ります。他の個人用ツールでは、業務パラメーターがなくても input オブジェクトが必要です。
list_models
必要な権限: models:read · 読み取り
結果: items、total、page、page_size と公開モデル ID・価格・機能を返します。
get_model_schema
必要な権限: models:read · 読み取り
結果: 利用可能なモデルの対応パラメーター・機能・価格を返します。
get_api_guide
必要な権限: models:read · 読み取り
結果: format の接続 URL、認証の例、エンドポイント、タスク確認方法を返します。
chat_completion
必要な権限: models:invoke · 書き込み。idempotencyKey 必須
結果: HTTP status、request_id、credits_charged、content_type と response または収集した events を返します。非同期処理は get_task で確認します。受付は完了を意味しません。
body は対応 HTTP JSON 全体です。generate_content は外側の model が必須、他は body.model を読みます。files は画像編集フィールド名と自分のファイル ID 配列の対応で、files:write も必要です。client_request_id は動画照合用です。HTTP リファレンスを参照。
create_response
必要な権限: models:invoke · 書き込み。idempotencyKey 必須
結果: HTTP status、request_id、credits_charged、content_type と response または収集した events を返します。非同期処理は get_task で確認します。受付は完了を意味しません。
body は対応 HTTP JSON 全体です。generate_content は外側の model が必須、他は body.model を読みます。files は画像編集フィールド名と自分のファイル ID 配列の対応で、files:write も必要です。client_request_id は動画照合用です。HTTP リファレンスを参照。
create_message
必要な権限: models:invoke · 書き込み。idempotencyKey 必須
結果: HTTP status、request_id、credits_charged、content_type と response または収集した events を返します。非同期処理は get_task で確認します。受付は完了を意味しません。
body は対応 HTTP JSON 全体です。generate_content は外側の model が必須、他は body.model を読みます。files は画像編集フィールド名と自分のファイル ID 配列の対応で、files:write も必要です。client_request_id は動画照合用です。HTTP リファレンスを参照。
generate_content
必要な権限: models:invoke · 書き込み。idempotencyKey 必須
結果: HTTP status、request_id、credits_charged、content_type と response または収集した events を返します。非同期処理は get_task で確認します。受付は完了を意味しません。
body は対応 HTTP JSON 全体です。generate_content は外側の model が必須、他は body.model を読みます。files は画像編集フィールド名と自分のファイル ID 配列の対応で、files:write も必要です。client_request_id は動画照合用です。HTTP リファレンスを参照。
generate_image
必要な権限: models:invoke · 書き込み。idempotencyKey 必須
結果: HTTP status、request_id、credits_charged、content_type と response または収集した events を返します。非同期処理は get_task で確認します。受付は完了を意味しません。
body は対応 HTTP JSON 全体です。generate_content は外側の model が必須、他は body.model を読みます。files は画像編集フィールド名と自分のファイル ID 配列の対応で、files:write も必要です。client_request_id は動画照合用です。HTTP リファレンスを参照。
generate_image_sync
必要な権限: models:invoke · 書き込み。idempotencyKey 必須
結果: HTTP status、request_id、credits_charged、content_type と response または収集した events を返します。非同期処理は get_task で確認します。受付は完了を意味しません。
body は対応 HTTP JSON 全体です。generate_content は外側の model が必須、他は body.model を読みます。files は画像編集フィールド名と自分のファイル ID 配列の対応で、files:write も必要です。client_request_id は動画照合用です。HTTP リファレンスを参照。
edit_image
必要な権限: models:invoke · 書き込み。idempotencyKey 必須
結果: HTTP status、request_id、credits_charged、content_type と response または収集した events を返します。非同期処理は get_task で確認します。受付は完了を意味しません。
body は対応 HTTP JSON 全体です。generate_content は外側の model が必須、他は body.model を読みます。files は画像編集フィールド名と自分のファイル ID 配列の対応で、files:write も必要です。client_request_id は動画照合用です。HTTP リファレンスを参照。
ファイル操作は内容を読む前に、所有者、準備状態、件数、サイズを確認します。同じ ID を繰り返しても、各参照が件数と合計サイズに加算されます。
edit_image：全フィールドで最大 20 ファイル、うち mask は最大 1 ファイル。1 ファイル 50 MiB、合計 100 MiB。入力スキーマの各配列上限も適用されます。
generate_video
必要な権限: models:invoke · 書き込み。idempotencyKey 必須
結果: HTTP status、request_id、credits_charged、content_type と response または収集した events を返します。非同期処理は get_task で確認します。受付は完了を意味しません。
body は対応 HTTP JSON 全体です。generate_content は外側の model が必須、他は body.model を読みます。files は画像編集フィールド名と自分のファイル ID 配列の対応で、files:write も必要です。client_request_id は動画照合用です。HTTP リファレンスを参照。
generate_video_sync
必要な権限: models:invoke · 書き込み。idempotencyKey 必須
結果: HTTP status、request_id、credits_charged、content_type と response または収集した events を返します。非同期処理は get_task で確認します。受付は完了を意味しません。
body は対応 HTTP JSON 全体です。generate_content は外側の model が必須、他は body.model を読みます。files は画像編集フィールド名と自分のファイル ID 配列の対応で、files:write も必要です。client_request_id は動画照合用です。HTTP リファレンスを参照。
moderate_content
必要な権限: models:invoke · 書き込み。idempotencyKey 必須
結果: HTTP status、request_id、credits_charged、content_type と response または収集した events を返します。非同期処理は get_task で確認します。受付は完了を意味しません。
body は対応 HTTP JSON 全体です。generate_content は外側の model が必須、他は body.model を読みます。files は画像編集フィールド名と自分のファイル ID 配列の対応で、files:write も必要です。client_request_id は動画照合用です。HTTP リファレンスを参照。
upload_image
必要な権限: models:invoke, files:write · 書き込み。idempotencyKey 必須
結果: JPEG・PNG・WebP を公開し、標準レスポンス内にモデル入力用 URL を返します。URL は共有可能です。
ファイル操作は内容を読む前に、所有者、準備状態、件数、サイズを確認します。同じ ID を繰り返しても、各参照が件数と合計サイズに加算されます。
upload_image：1 ファイル、最大 50 MiB。
upload_media
必要な権限: files:write · 書き込み。idempotencyKey 必須
結果: 画像・動画・音声を公開して URL を返します。私的アップロードとは別の操作で、公開 URL は共有可能です。
ファイル操作は内容を読む前に、所有者、準備状態、件数、サイズを確認します。同じ ID を繰り返しても、各参照が件数と合計サイズに加算されます。
upload_media：最大 20 ファイル、合計 250 MiB。
get_task
必要な権限: models:invoke · 読み取り
結果: 既存の自分のタスクの状態と結果。新規作成や再課金はありません。
list_utilities
必要な権限: models:read · 読み取り
結果: items にツール id、名前、説明、メソッド、body_kind、response_kind、fields、limits、access を返します。
get_utility_schema
必要な権限: models:read · 読み取り
結果: ツールの入力項目、対応ファイル形式、既定値、容量制限、利用条件。
run_utility
必要な権限: utilities:invoke · 書き込み。idempotencyKey 必須
結果: status と JSON result、またはバイナリ・大きな結果の一時 artifact を返します。ファイル利用と非 JSON 出力は files:write も必要です。利用条件と上限は引き続き適用されます。
ファイル操作は内容を読む前に、所有者、準備状態、件数、サイズを確認します。同じ ID を繰り返しても、各参照が件数と合計サイズに加算されます。
run_utility：get_utility_schema が返す件数・個別サイズ・合計サイズの上限に従います。カタログの値が大きくても、合計は 250 MiB を超えられません。
begin_upload
必要な権限: files:write · 書き込み。idempotencyKey 必須
結果: 一時ファイルの id、name、mime_type、size、status、expires_at、sha256。以後は id を file_id に指定します。
upload_chunk
必要な権限: files:write · 書き込み。idempotencyKey 必須
結果: file_id、index、received: true。Base64 復号後は最大 1 MiB。同じインデックスには同一バイト列が必要です。
finish_upload
必要な権限: files:write · 書き込み。idempotencyKey 必須
結果: 検証済みメタデータ、status: ready、SHA-256。連続する全チャンクと申告どおりのバイト数が必要です。
get_artifact
必要な権限: files:write · 読み取り
結果: offset なしはメタデータとサイトログインが必要な download_url。指定時は Base64 data、offset、next_offset。null は末尾。既定の読み取り量は 1 MiB です。
list_api_keys
必要な権限: keys:read · 読み取り
結果: 設定とキー接頭辞の一覧。秘密値は含みません。
get_api_key
必要な権限: keys:read · 読み取り
結果: 選択した自分のキーの設定。秘密値なし。
create_api_key
必要な権限: keys:write · 書き込み。idempotencyKey 必須
結果: 新規キーのメタデータのみ。秘密値にはサイト承認が必要です。purpose はラベルで、MCP 権限を与えません。
update_api_key
必要な権限: keys:write · 書き込み。idempotencyKey 必須
結果: 更新後の設定。key_id 以外に設定を一つ以上指定します。
set_api_key_status
必要な権限: keys:write · 書き込み。idempotencyKey 必須
結果: active または disabled 状態の更新済み設定。
delete_api_key
必要な権限: keys:write · 書き込み。idempotencyKey 必須
結果: 確認済み id、status: deleted、deletedAt。削除したキーは再有効化できません。
start_reveal_key_action
必要な権限: keys:secrets · 書き込み。idempotencyKey 必須
結果: 保留中の操作の id、confirmation_url、expires_at、内容。秘密値は返しません。
reveal_api_key
必要な権限: keys:secrets · 書き込み。idempotencyKey 必須
結果: 承認後に action_id、key_id、秘密値 key を一度だけ返します。再送しても秘密値は返りません。
get_profile
必要な権限: account:read · 読み取り
結果: 自分のプロフィール、現在の契約、freeApi の利用条件・RPM・一括利用可否。
フィールドなし。input: {} を指定します。
get_account_capabilities
必要な権限: account:read · 読み取り
結果: scopes、bound_api_key_id、free_api の区分・RPM、確認操作の種類。
フィールドなし。input: {} を指定します。
update_profile
必要な権限: account:write · 書き込み。idempotencyKey 必須
結果: 更新後のプロフィール。name または image が必要で、空の画像値は削除を意味します。HTTP(S) URL または対応画像 data URL を使えます。
list_login_records
必要な権限: account:read · 読み取り
結果: 最近のログイン items：時刻、方法、IP、場所。セッショントークンなし。
get_integration_config
必要な権限: account:read · 読み取り
結果: API・MCP 接続 URL と認証情報のプレースホルダーのみ。
フィールドなし。input: {} を指定します。
start_account_action
必要な権限: account:write · 書き込み。idempotencyKey 必須
結果: サイト確認待ちの操作。パスワード変更とアカウント削除はサイトで行います。
get_account_action
必要な権限: account:read · 読み取り
結果: 自分の操作の status、確認リンク、有効期限、対象、完了時刻。
get_balance
必要な権限: billing:read · 読み取り
結果: アカウントの balance と、設定されていれば紐付いたキーの予算・残額。
フィールドなし。input: {} を指定します。
list_credit_transactions
必要な権限: billing:read · 読み取り
結果: クレジット取引一覧：金額、増減、状態、日付、関連注文・契約。
list_orders
必要な権限: billing:read · 読み取り
結果: 注文一覧：状態、金額、通貨、商品、支払日時。作成済み注文は支払証明ではありません。
list_billing_products
必要な権限: billing:read · 読み取り
結果: 現在の商品 ID・価格・通貨・クレジット数。決済には返された productId を product_id に指定します。
フィールドなし。input: {} を指定します。
create_checkout
必要な権限: billing:write · 書き込み。idempotencyKey 必須
結果: checkout_url と order_no。ユーザーがサイトで支払い、get_payment_status で確認します。
get_payment_status
必要な権限: billing:read · 読み取り
結果: 自分の注文の支払状態・金額・通貨・支払時刻。必要に応じて審査状態も含みます。
get_invoice
必要な権限: billing:read, files:write · 書き込み。idempotencyKey 必須
結果: order_no と一時 PDF file。支払方法により提供可否が異なります。ファイル作成のため冪等キーが必要です。
resend_invoice
必要な権限: billing:write · 書き込み。idempotencyKey 必須
結果: order_no、送信先 email、sent: true。注文登録済みアドレスへ実際にメール送信するため、依頼された場合のみ実行します。
list_subscriptions
必要な権限: billing:read · 読み取り
結果: 契約一覧のメタデータ・商品・状態・請求期間・解約日。
get_current_subscription
必要な権限: billing:read · 読み取り
結果: 現在の subscription メタデータ。ない場合は null。
フィールドなし。input: {} を指定します。
cancel_subscription
必要な権限: billing:write · 書き込み。idempotencyKey 必須
結果: 一つの契約の確認待ち操作を開始します。サイトでの確認と完了確認までは解約済みではありません。
list_redemptions
必要な権限: billing:read · 読み取り
結果: 最近の自分の引換履歴 items。
redeem_code
必要な権限: billing:write · 書き込み。idempotencyKey 必須
結果: 追加された credits と redeemed: true。無効・使用済みコードはエラーになります。
get_credit_alert
必要な権限: billing:read · 読み取り
結果: しきい値、メール/Webhook 設定、webhookConfigured、頻度。秘密を含む URL は返しません。
フィールドなし。input: {} を指定します。
update_credit_alert
必要な権限: billing:write · 書き込み。idempotencyKey 必須
結果: 更新後の設定。最低一項目が必要です。Webhook は公開 HTTP(S) URL を指定します。
test_credit_alert
必要な権限: billing:write · 書き込み。idempotencyKey 必須
結果: delivery で実際の残高通知を送信。送信種別、残高、しきい値、取得可能な HTTP 状態を返します。依頼時のみ実行してください。
get_overview
必要な権限: usage:read · 読み取り
結果: timezoneOffset に応じた概要：ユーザー、残高、キー、利用状況、最近の活動、契約。
list_usage
必要な権限: usage:read · 読み取り
結果: 保存期間内のリクエスト一覧と UTC window。不明なキャッシュトークン数は null。
利用履歴はタイムゾーン付き ISO 8601 の
from 以上・to 未満です。既定は直近 30 日、最大 366 日。保存期間内の記録のみで、日付の欠落は利用ゼロを意味しません。get_overview.timezoneOffset は JavaScript getTimezoneOffset の分（UTC−現地時刻）で既定 0。履歴一覧と集計は UTC です。
get_usage_detail
必要な権限: usage:read · 読み取り
結果: 自分のリクエストの状態・時間・料金。内容取得には include_content: true、usage:content、キーの内容記録設定が必要です。
diagnose_request
必要な権限: usage:read · 読み取り
結果: request_id、task_id、状態、実際のエラーコード、料金・返金、対処案。モデル実行や自動再試行はありません。
summarize_usage
必要な権限: usage:read · 読み取り
結果: 保存期間内の全一致リクエストの totals、groups、group_by、UTC window。存在しない日は省略し、cachedTokens は不明です。返金集計は紐付いた非同期タスクのみ。
利用履歴はタイムゾーン付き ISO 8601 の
from 以上・to 未満です。既定は直近 30 日、最大 366 日。保存期間内の記録のみで、日付の欠落は利用ゼロを意味しません。get_overview.timezoneOffset は JavaScript getTimezoneOffset の分（UTC−現地時刻）で既定 0。履歴一覧と集計は UTC です。
summarize_usage の creditsCharged と netCreditsCharged は保存記録の純請求額です。linkedRefundCredits は非同期タスクに紐付いた既知の返金のみ。knownGrossCredits は純額とその返金の和で、完全な総支出ではありません。totalTokens、averageLatencyMs、pending、processing は一致する保存記録の値です。
list_executions
必要な権限: account:read · 読み取り
結果: 実行記録一覧：操作、状態、識別子、エラーコード、時刻。
get_execution
必要な権限: account:read · 読み取り
結果: 自分の実行記録一件。pending・unknown の確認に使用し、完全な出力や秘密値は再取得しません。
ユーティリティ一覧：32 種類
各 slug をrun_utility.input.utility に指定します。先に get_utility_schema を呼び、fields の名前・型・必須・既定値・複数ファイル可否・形式、limits と access の容量・件数・利用条件を確認します。単一ファイル版から一括版の入力を推測しないでください。