ドキュメントを探す
はじめに
アクセスの確認、リクエストの修正、FlashDataの使用に関する回答の検索
このページの内容
無料のアクセスチェックで始める
タスクが失敗したチェックを実行します。 既存の資格情報を使用してください。これらのコマンドはクエリを送信しません。
保存したCLIアクセスを使用します。 名前付きプロファイルの場合は、--profile NAME を各コマンドに追加します。 これらはクエリクレジットを消費しません。
flashdata --version
flashdata doctor --offline
flashdata auth status --json同じターミナル、コンテナ、またはスケジュールされたジョブでタスクの既存の FLASHDATA_API_KEY を使用します。 cURL 7.76+を要求して下さい。
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)同じターミナル、コンテナ、またはスケジュールされたジョブでタスクの既存の FLASHDATA_API_KEY を使用します。
& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/identity"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}確認するべきこと
アイデンティティは、access: readyを持っており、スコープ内のソースを含める必要があります。 CLI JSONでは、アイデンティティはdata.identity.identityです;またdata.accessVerified: trueを要求します。 accessVerified: false で成功したコマンドは、アクセスを検証していません。
名前付きCLIプロファイルは、以下のすべてのコマンドに--profile NAMEを付加します。 --state-dir と OS のオリジナルユーザーをキープします。 FLASHDATA_API_KEYは保存されたCLIキーをオーバーライドします; SDK と MCP ホストは、独自のクレデンシャル設定を使用します。
問題を見つけて修正する
エラーにマッチする症状を開きます。 IDs と元のタスクからレシートを使用してください。
コマンドが見つからなかったり、不足しているプロファイル
実行できません: OS/CPU のリリースをインストールし、PATH にディレクトリを追加します。 プロフィールを欠くこと:元のOSユーザーおよび州のディレクトリを使用して下さい。 スケジューラやコンテナ内もチェックします。
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401/403:キー、規模またはexpiry
保存された所有者キーを交換するには、承認されたキーを隠しプロンプトに貼り付けます。 FLASHDATA_API_KEYが設定されている場合は、代わりに実行時にシークレットを更新します。別のCLIキーを保存すると、それを上書きしません。
- 401: 期限切れのチェック, 再発または誤って設定されたキー. 403: 要求されたソースをアイデンティティのスコープと比較します。.
- REST および SDK は X-API-Key を使用します。 MCP OAuthトークンはAPIキーを交換できません。 一時的なアクセスには、以下のクレームの回復を使用します。
flashdata auth login --replace
flashdata auth status --jsonクレームは承認しましたが、エージェントはまだトライアルアクセスを持っています
クレームを作成した同じCLIプロファイルでhandoffを終了します。 所有者は、ブラウザでサインアップ、電子メールの検証、同意を完了します。 CLIは、資格を受け取ります。
flashdata auth finish --wait --timeout 10m
flashdata auth status --json既存のトライアルに新しいリンクをリクエストし、所有者が承認し、auth finishを実行します。 initを再度動かさない。
flashdata auth claim402:不十分なクレジット
availableCreditsをソースの現在の価格と比較します。 所有者の残高を使用するために、または再試行する前に、所有者がBillingを見直して、徹底した試みを主張します。
保存したCLIアクセスを使用します。 名前付きプロファイルの場合は、--profile NAME を各コマンドに追加します。 これらはクエリクレジットを消費しません。
flashdata account balance
flashdata account pricing --source google_search --request-count 1同じターミナル、コンテナ、またはスケジュールされたジョブでタスクの既存の FLASHDATA_API_KEY を使用します。 cURL 7.76+を要求して下さい。
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/balance' || exit
printf '\n'
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/pricing?source=google_search&request_count=1' || exit
printf '\n'
)同じターミナル、コンテナ、またはスケジュールされたジョブでタスクの既存の FLASHDATA_API_KEY を使用します。
& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/balance"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
$flashdataUri = "$flashdataBase/api-access/pricing?source=google_search&request_count=1"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}429: 再試行する前に待ちます
Retry-Afterを失敗した応答で読みます:秒またはHTTP日付。 その後まで待ってから、通貨を削減します。 トライアル登録では、24-hour ウィンドウごとの IP ごとの 3 つの登録が可能で、元のプロファイルと登録証明書を再利用できます。
ヘッダー、ステータス、ボディの保存を自由に読み取ります。 失敗した操作からRetry-Afterを使用してください。 クエリ、登録、およびアカウント読み取り制限は異なる場合があります。
# Bash + cURL + jq. This is a free account read.
(
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
curl --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--dump-header diagnostic-headers.txt --output diagnostic.json \
--write-out '%{http_code}\n' \
'https://api.flashdata.dev/v2/api-access/identity' > diagnostic-status.txt || exit
printf 'HTTP '; cat diagnostic-status.txt
awk 'tolower($1) == "retry-after:" {
$1=""; sub(/^ /, ""); sub(/\r$/, ""); print "Retry-After: " $0
}' diagnostic-headers.txt
if jq -e 'type == "object"' diagnostic.json >/dev/null 2>&1; then
jq '{access, scopes, status, code, requestId}
| with_entries(select(.value != null))' diagnostic.json
else
printf 'Non-JSON response saved in diagnostic.json; check the HTTP status.\n'
fi
)flashdata account limits400/422:入力または処理失敗を拒否しました
HTTP エラーからコード、詳細、fieldErrors を読みます。 ボディリクエストを修正し、request.jsonとして保存し、それを検証します。 専用の入力ファイルでストレージの認証情報をダウンロードしてください。 422 が既存のジョブの結果から来ている場合は、まず job.error を調べます。
flashdata query --input request.json --mode async --dry-run --jsonジョブの終了、または失敗したジョブで HTTP 200
submission.jsonからジョブを読み、保存した非同期レシート。 HTTP 200 ステータスの読み込みが成功することを意味します。 job.status タスクのアウトカム(タスクアウトカム)です。data.status でん CLI JSON). Batch では、関連するエントリを submission.json として保存します。
| 状態またはエラー | 次のアクション |
|---|---|
| pending / processing | 同じ仕事を待ってから、もう一度送信しないでください。 |
| completed | 既存の結果をフェッチして保存します。 |
| failed | 修正された作業を提出する前に、job.error を検査します。 |
| 404 | ジョブのIDと送信アカウントを確認します。 |
| 409 | 結果は未準備です。 同じジョブをポーリングしてください。 |
| 410 | 店舗情報 JSON 期限切れ以降 24 営業時間 保存されたコピーを使用して下さい; 渡された媒体に自身の貯蔵の保持があります。 |
# Bash + jq. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)flashdata jobs wait JOB_IDflashdata jobs result JOB_ID --output recovered-result.json# Bash + cURL + jq. Read the saved async submission receipt.
(
set -e
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
STATUS_URL=$(jq -er '(.submission // .).links[]
| select(.rel == "self") | .href' submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Accept: application/json' \
"$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)タイムアウト / 5xx: タスクが受け入れられましたか?
CLI output_exists: 結果ファイルが既に存在する
CLIは--outputファイルを上書きしません。 既存のファイルを読むか、元の--run-idおよび要求を保ちながら新しい出力ファイル名を選ぶか。 このエラーを迂回するために、新しい実行IDを発明しないでください。
flashdata runs show RUN_ID空の検索, 欠落のキャプションや未読のダウンロード
これらのコマンドは、CLIのstdoutのエンベロープではなく、ローカルの結果ファイルのみを読み取ります。
ステータスが終了し、有機物が空の場合、クエリフィルタを緩めます。 タスクレコードの空の結果を保持します。
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonMetadataは、トラックが手動か自動であるか否かではなく、言語コードをリストします。 リストされている言語を選択し、自動設定 explicitly: true 自動のため、 false マニュアル用 マッチングトラックは、その選択のためのキャプションを意味しません。 FlashData は置換を生成しません。
jq '.results[0].transcriptLanguages' metadata.json完成したdelivery.jsonのレシートを読んで下さい。 宛先の資格情報でオブジェクトをダウンロードし、そのサイズとMD5をレシートと比較します。 file_urlは、配送後に公開されません。
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonMCP ツールの欠落または認証期限切れ
タスクを実行しているホストを確認してください。 リストされたサーバーは、設定が確認され、作業接続ではなく、確認します。 設定されたホストされているOAuth接続がログインを必要とする場合は、ログインコマンドを実行し、ブラウザの承認を完了し、ツールリストを更新します。
Codex CLI で /mcp を開き、接続状況とツールを確認します。 アプリでは、設定されたサーバーを確認し、設定されたサーバーをセットアップ変更後に新しいセッションを開始します。
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeOAuthログインはAPIキー接続を修復しません。 ホストの環境とそのソースの権限でキーを確認します。 ローカル stdio では、MCP パッケージの Node.js 要件を確認し、環境を更新した後にホストを再起動します。
node --versionスキルがインストールされていますが、エージェントは見つけたり使用したりすることはできません
同じプロジェクト、ホストプロファイル、インストール場所を確認し、新しいエージェントセッションを開始します。 CLIのタスクスキルは、CLIが必要です。 Flashdata-mcpは、接続されたMCPサーバーを必要とします。 スキルのインストールは、サーバーやアカウントの権限を付与しない。
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkよくある質問
接続する
AIエージェントが必要ですか?
いいえ。 HTTP API、Go/Python/TypeScript SDK、CLIまたはコンソールを直接使用して下さい。 MCP とスキルは、エージェントのオプションです。
どのインターフェイスを選ぶべきか。
アプリ内の SDK または HTTP API と、端末タスクの CLI と MCP を MCP 対応ホストに使用します。 スキルは、CLIタスクまたは接続されたMCPツールの指示を提供しており、認証を交換しません。
タスクを再発するための資格情報を再利用できますか?
はい。 所有者のアクセスを使用し、同じ保護されたCLIプロファイル、ランタイムシークレットまたはMCP接続を維持します。 API-keyアクセスは、recurringAllowed: trueをチェックします。 ホストまたはスケジューラがスケジュールを実行します。
ローカル設定の削除はアクセスを再開しますか?
いいえ。 APIキーまたはコンソール内の接続を再起動します。 ローカル設定を削除すると、ローカルコピーが削除されます。
トライアルとクレジット
エージェントは、サインアップ前にFlashDataを試すことができますか?
はい、CLI または API をオンボーディングする資格のある一時的なアクセスと。 同じプロフィールおよび登録証拠を再使用して下さい。 既存の所有者であるAPIキーを要求するか、または要求する継続的使用の必要性。
別の試用助成金を申し立てますか?
Clunt自体は、追加の試用クレジットを付与しません。 将来のリクエストは、所有者のアカウント残高を使用しており、未使用の一時的なクレジットは譲渡しません。 新しく作成されたアカウントは、通常のサインアップクレジットポリシーに従います。
クレジットカバーのリクエストはいくつありますか?
口座残高とソース価格をチェックしてください。 リクエストカウントはソースに依存し、混合ソースタスクは1つのバランスを共有します。 YouTube Downloadは、固定リクエストカウントではなく、ダウンロードしたバイトによって価格付けられます。
ソースと結果
エージェントの検索がダウンロードできないのはなぜですか?
所有者のアクセス、youtube_downloadの許可および宛先の貯蔵をダウンロードして下さい。 仮試用版とmcp:research OAuthにはダウンロードは含まれていません。 認定の所有者 API キーはそれを使用してそれを使うことができます CLI, HTTP または MCP.
Google Searchはフルウェブページを返しますか?
検索結果と抜粋を返します。 アプリケーションやエージェントが選択したURLsを読み込みます。
FlashDataは、ビデオの要約やキャプションを生成しますか?
メタデータと既存のキャプションを取得します。 欠落したキャプションを生成しません。モデルが利用可能な結果からサマリーを書きます。
それでも立ち往生? 最小限のレポートを送信します。
保存する HTTP エラー ボディか CLI JSON エラーから stderr として diagnostic.json. 失敗したコマンドの後にのみ、識別子を抽出します。 鍵、プライベートなクエリテキスト、およびレポートからURLsに署名したままにしてください。 非JSON応答では、diagnostic-status.txtからHTTPステータスを報告します。
flashdata auth status --json 2> diagnostic.json# A saved HTTP error or CLI --json error; local files only.
date -u '+%Y-%m-%dT%H:%M:%SZ'
jq '(.error // .) as $e | {
status: ($e.httpStatus // $e.status),
code: $e.code,
requestId: $e.requestId,
runId: (.runId // $e.runId),
jobId: $e.remoteId,
retryAfter: $e.retryAfter
} | with_entries(select(.value != null))' diagnostic.jsonUTCの時間:
クライアント+バージョン:
ソース+ステージ(auth / submit / poll / fetch):
HTTPステータス+エラーコード:
ID/仕事ID/操業IDを要求して下さい:
提出結果: 受理/拒否/未知
期待される対の実際の結果: