문서 둘러보기
시작하기
액세스 확인, 실패 요청을 수정하거나 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 이름을 아래 각 명령에 추가하십시오. 원래 --state-dir 및 OS 사용자를 유지하십시오. FLASHDATA_API_KEY는 저장한 CLI 열쇠를 overrides; SDK 및 MCP 호스트는 자체 자격 구성을 사용합니다.
문제 찾기 및 수정
오류를 일치 symptom을 엽니 다. 원래 작업에서 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: ID의 범위에 요구한 근원을 비교하십시오.
- REST 및 SDK는 X-API-Key를 사용합니다. MCP OAuth 토큰은 API 키를 대체할 수 없습니다. 임시 접근을 위해, 아래의 청구 복구를 사용하십시오.
flashdata auth login --replace
flashdata auth status --jsonClaim 승인, 하지만 에이전트는 여전히 체험 액세스를 가지고
같은 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 날짜. 그때까지 대기하고 concurrency을 감소. 시험 등록은 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로 저장, 다음 그것을 검증. 개인 입력 파일에 저장 credentials를 다운로드하십시오. 422가 기존 작업의 결과에서 제공되면 job.error를 먼저 검사합니다.
flashdata query --input request.json --mode async --dry-run --json실패한 일을 가진 직업, 또는 HTTP 200
submission.json에서 일자리를 읽으십시오. 저장된 동기화 영수증. HTTP 200는 상태가 성공한 것을 의미합니다; job.status는 CLI JSON에 있는 작업 결과 (data.status)입니다. Batch의 경우 submission.json로 쿼리의 관련 항목을 저장합니다.
| 국가 또는 오류 | 다음 작업 |
|---|---|
| pending / processing | 같은 일을 기다립니다; 다시 제출하지 마십시오. |
| completed | Fetch 및 기존 결과를 저장합니다. |
| 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
)Timeout / 5xx : 작업이 허용되었습니까?
CLI output_exists: 이미 존재하는 결과 파일
CLI는 --output 파일을 덮지 않습니다. 기존 파일을 읽거나 기존 --run-id 및 요청을 유지하면서 새로운 출력 파일 이름을 선택하십시오. 새로운 실행 ID를 발명하지 마십시오.
flashdata runs show RUN_ID빈 검색, 누락된 캡션 또는 읽을 수없는 다운로드
이 명령은 CLI의 stdout envelope가 아닌 로컬 결과 파일을 읽을 수 있습니다.
상태가 완료되고 유기가 빈 경우에, 느슨한 질문 여과기. 작업 기록에서 빈 결과를 유지하십시오.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonMetadata lists language codes, 트랙이 수동 또는 자동인지 여부. 목록 언어 선택 및 자동 설정 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 연결을 설정하면 로그인 명령을 실행하고 브라우저 승인을 완료하고 도구 목록을 새로 고침하십시오.
/mcp를 Codex CLI에서 연결 상태 및 도구를 확인하십시오. 앱에서 구성된 서버를 확인하고 설정 변경 후 신선한 세션을 시작합니다.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeOAuth 로그인은 API-key 연결을 복구하지 않습니다. 호스트의 환경과 그 소스 권한에서 키 확인. 로컬 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 캡블 호스트. Skills는 CLI 작업 또는 MCP 도구에 대한 지침을 제공합니다. 인증은 대체하지 않습니다.
재발급 작업에 대한 자격 증명을 재사용 할 수 있습니까?
예. 소유자 액세스 및 같은 보호 된 CLI 프로파일, 실행 시간 비밀 또는 MCP 연결을 보존합니다. API-key 액세스의 경우 recurringAllowed: true를 확인하십시오. 호스트 또는 스케줄러가 일정을 실행합니다.
로컬 설정을 삭제하는 것은 액세스를 취소합니까?
아니요. 콘솔에서 API 키나 연결을 취소하세요. 로컬 설정을 삭제해도 해당 로컬 사본만 제거됩니다.
시험 및 학점
에이전트가 서명하기 전에 FlashData를 시도 할 수 있습니까?
예, CLI 또는 API를 통해 해당 임시 액세스와 함께. 동일한 단면도 및 등록 증거를 재사용하십시오. 계속 사용은 주장하거나 기존 소유자 API 열쇠를 필요로 합니다.
다른 체험 보조금을 추가합니까?
자체가 추가 평가 크레딧을 부여하지 않습니다. 미래 요청은 소유자의 계정 잔액을 사용합니다. 사용하지 않는 임시 크레딧은 전송하지 않습니다. 새로 생성된 계정은 정상적인 Signup-credit 정책을 따릅니다.
몇 가지 요청이 내 크레딧 커버 할 수 있습니까?
계정 잔고 및 소스 가격을 확인합니다. 요청은 소스에 따라 달라지고, 혼합 자원 작업은 한 잔의 균형을 공유합니다. YouTube Download는 고정 요청 카운트가 아닌 다운로드 된 바이트로 가격이 책정됩니다.
출처 및 결과
왜 내 에이전트 검색을 할 수 있지만 다운로드 할 수 없습니다?
소유자 액세스, youtube_download 권한 및 대상 저장을 다운로드하십시오. 임시 체험 및 mcp:research OAuth는 다운로드를 포함하지 않습니다. 공인 소유자 API 키는 CLI, HTTP 또는 MCP를 통해 사용할 수 있습니다.
Google Search는 전체 웹 페이지를 반환합니까?
검색 결과와 발췌를 반환합니다. 앱 또는 에이전트는 선택한 URLs를 읽습니다.
FlashData는 비디오 요약 또는 캡션을 생성합니까?
metadata와 기존의 captions를 검색합니다. 그것은 누락 된 캡션을 생성하지 않습니다. 모델은 사용 가능한 결과에서 요약을 작성합니다.
아직도 붙어? 최소 보고를 보내세요
HTTP 오류 바디 또는 CLI JSON 오류를 stderr에서 diagnostic.json로 저장하십시오. 실패한 명령 후에 만 추출 식별자. 키, 개인 쿼리 텍스트를 유지하고 보고서에서 URLs를 서명했습니다. 비-JSON 응답을 위해, HTTP 상태를 diagnostic-status.txt에서 보고하십시오.
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 / 제출 / poll / fetch) :
HTTP 상태 + 오류 코드:
ID/작업 ID/런 ID:
제출 결과 : 허용 / 거부 / 알 수없는
예상 대 실제 결과: