コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

はじめに

よくある質問とトラブルシューティング

アクセスの確認、リクエストの修正、FlashDataの使用に関する回答の検索

このページの内容

無料のアクセスチェックで始める

タスクが失敗したチェックを実行します。 既存の資格情報を使用してください。これらのコマンドはクエリを送信しません。

保存したCLIアクセスを使用します。 名前付きプロファイルの場合は、--profile NAME を各コマンドに追加します。 これらはクエリクレジットを消費しません。

無料アカウントの読み込み
flashdata --version
flashdata doctor --offline
flashdata auth status --json

確認するべきこと

アイデンティティは、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 --offline

401/403:キー、規模またはexpiry

保存された所有者キーを交換するには、承認されたキーを隠しプロンプトに貼り付けます。 FLASHDATA_API_KEYが設定されている場合は、代わりに実行時にシークレットを更新します。別のCLIキーを保存すると、それを上書きしません。

  1. 401: 期限切れのチェック, 再発または誤って設定されたキー. 403: 要求されたソースをアイデンティティのスコープと比較します。.
  2. 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

402:不十分なクレジット

availableCreditsをソースの現在の価格と比較します。 所有者の残高を使用するために、または再試行する前に、所有者がBillingを見直して、徹底した試みを主張します。

保存したCLIアクセスを使用します。 名前付きプロファイルの場合は、--profile NAME を各コマンドに追加します。 これらはクエリクレジットを消費しません。

無料アカウントの読み込み
flashdata account balance
flashdata account pricing --source google_search --request-count 1

429: 再試行する前に待ちます

Retry-Afterを失敗した応答で読みます:秒またはHTTP日付。 その後まで待ってから、通貨を削減します。 トライアル登録では、24-hour ウィンドウごとの IP ごとの 3 つの登録が可能で、元のプロファイルと登録証明書を再利用できます。

ヘッダー、ステータス、ボディの保存を自由に読み取ります。 失敗した操作からRetry-Afterを使用してください。 クエリ、登録、およびアカウント読み取り制限は異なる場合があります。

応答を捕獲して下さい · Bash/cURL/jq
# 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 limits

400/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
# 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
)
まだ実行中・返されたJOB_IDを使用
flashdata jobs wait JOB_ID
完了・新しい出力ファイル名を使用する
flashdata jobs result JOB_ID --output recovered-result.json

タイムアウト / 5xx: タスクが受け入れられましたか?

POSTを再試行する前に、元の実行とHistoryを調べます。 確認済みのジョブを回復します。 受諾が不明な場合は、実行 ID と連絡先サポートを維持してください。 IDs を変更し、再送信すると、料金を複製することができます。

第一線・RUN_IDを交換
flashdata runs show RUN_ID
確認済みの作業を回復する
flashdata runs recover RUN_ID

CLI output_exists: 結果ファイルが既に存在する

CLIは--outputファイルを上書きしません。 既存のファイルを読むか、元の--run-idおよび要求を保ちながら新しい出力ファイル名を選ぶか。 このエラーを迂回するために、新しい実行IDを発明しないでください。

オリジナルランを調べる
flashdata runs show RUN_ID

空の検索, 欠落のキャプションや未読のダウンロード

これらのコマンドは、CLIのstdoutのエンベロープではなく、ローカルの結果ファイルのみを読み取ります。

MCP ツールの欠落または認証期限切れ

タスクを実行しているホストを確認してください。 リストされたサーバーは、設定が確認され、作業接続ではなく、確認します。 設定されたホストされているOAuth接続がログインを必要とする場合は、ログインコマンドを実行し、ブラウザの承認を完了し、ツールリストを更新します。

Codex CLI で /mcp を開き、接続状況とツールを確認します。 アプリでは、設定されたサーバーを確認し、設定されたサーバーをセットアップ変更後に新しいセッションを開始します。

設定をチェック
codex mcp list
OAuthログインが必要な時のみ
codex mcp login flashdata --scopes mcp:research

スキルがインストールされていますが、エージェントは見つけたり使用したりすることはできません

同じプロジェクト、ホストプロファイル、インストール場所を確認し、新しいエージェントセッションを開始します。 CLIのタスクスキルは、CLIが必要です。 Flashdata-mcpは、接続されたMCPサーバーを必要とします。 スキルのインストールは、サーバーやアカウントの権限を付与しない。

デフォルトのCLIスキルバンドルをチェックする
flashdata skills verify --agent codex

よくある質問

接続する

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ステータスを報告します。

無料CLIアクセスチェック・Bashをキャプチャ
flashdata auth status --json 2> diagnostic.json
エラー識別子の抽出・Bash/jq
# 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.json
サポートレポート
UTCの時間:
クライアント+バージョン:
ソース+ステージ(auth / submit / poll / fetch):
HTTPステータス+エラーコード:
ID/仕事ID/操業IDを要求して下さい:
提出結果: 受理/拒否/未知
期待される対の実際の結果: