# 비율 한계 및 사용법

Inspect 계정 용량, 비율 제한 및 트랙 완료 작업에 응답.

Canonical 참고: https://flashdata.dev/ko/docs/guides/usage-and-limits
검토: 2026-11-04 FlashData

<a id="limits"></a>

## 당신의 한계를 확인하십시오

제한은 계정과 계획을 따릅니다. 이 무료 체크를 실행하는 열쇠로 작업을 제출합니다. 계정의 모든 키는 동일한 용량을 공유합니다.

### CLI

저장된 CLI 액세스를 사용하십시오. 이름의 프로필에 --profile NAME을 각 명령에 추가합니다. 이 읽기는 쿼리 크레딧을 사용하지 않습니다.

#### 무료 계정 읽기

```bash
flashdata account limits
```

- [키 설정](https://flashdata.dev/ko/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Bash와 cURL 7.76+를 요구하십시오. 환경이 이미 FLASHDATA_API_KEY를 공급하는 경우 숨겨진 키 프롬프트를 건너 뛸 수 있습니다. 같은 터미널에서 읽기 명령을 실행합니다.

#### key를 설정하고, 이미 설정한 경우 건너뛰기

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```

#### 계정 읽기 JSON

```bash
(
: "${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/limits' || exit
printf '\n'
)
```


### PowerShell 7

FLASHDATA_API_KEY가 이미 설정되면 숨겨진 키 프롬프트를 건너 뛰십시오. 같은 터미널에서 읽기 명령을 실행합니다.

#### key를 설정하고, 이미 설정한 경우 건너뛰기

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```

#### 계정 읽기 JSON

```powershell
& {
  $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/limits"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```



<a id="capacity"></a>

### 각 제한을 이해

1개의 in-flight 요구로 시작해서, 그 후에 보고한 한계 안에 증가합니다. HTTP는 엔드포인트와 평가판 등록을 읽을뿐만 아니라 자체 속도 제한이 있습니다. 이 용량 필드는 요청당 최대 분의 quotas가 아닙니다.

| - 연혁 | 은둔 |
| --- | --- |
| limits.concurrency | 동시 작업을위한 플랜 천장, 무료 슬롯의 수 없습니다. |
| limits.batchSize | 1개의 배치 제출에 있는 최대 품목. |
| limits.pendingJobs | 계정의 최대 파기 작업. |
| current.pendingJobs | 읽는 시간에서 계산을 종료. 제출하기 전에 변경할 수 있습니다. |

- [시험 등록 제한](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md#trial-limits)

<a id="rate-limit"></a>

## 429 응답 핸들

오류 몸과 Retry-After 헤더를 읽으십시오. 무료 계정 읽기를 검사하려면 Bash 터미널에서이 실행하십시오. FLASHDATA_API_KEY가 설정됩니다. 헤더는 limits-headers.txt와 limits.json에 대한 응답으로 작성됩니다.

### 캡처 상태, 헤더 및 바디 · Bash / cURL

```bash
curl --silent --show-error --max-time 20 \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}" \
  --dump-header limits-headers.txt --output limits.json \
  --write-out 'HTTP %{http_code}\n' \
  https://api.flashdata.dev/v2/api-access/limits
cat limits-headers.txt limits.json
```


<a id="retry-example"></a>

### retrying 전에 대기

이 예제는 적어도 60 초를 기다립니다. Retry-After는 또한 HTTP 날짜일 수 있습니다. 반환 값, 고정 지연이 아닙니다.

#### 일러스트레이션 응답 헤더

```http
HTTP/1.1 429 Too Many Requests
Retry-After: 60
```


<a id="retry-actions"></a>

### 다음 작업을 선택하십시오

| - 연혁 | 조치 |
| --- | --- |
| 수용량 가득 차있는 | concurrency를 줄이거나 finish로의 구인을 기다립니다. |
| Retry-After 없음 | 지터와 무한 리트리 한계를 가진 모자를 씌운 백 오프를 사용하십시오. |
| 등록 제한 | 기다린 뒤 동일한 프로필, 입력 및 등록 증명으로 다시 시도하세요. IP를 바꾸지 마세요. |
| 제출 시간 | resubmitting 전에 기존 실행 또는 작업 검사; 그것의 outcome는 알 수 없습니다. |

- [중단 된 작업을 복구](https://flashdata.dev/ko/docs/guides/agent-recovery/reference.md)

<a id="usage"></a>

## 계정 사용

기본 창은 지난 7일입니다. 사용법은 이 열쇠가 접근할 수 있는 근원에 제한된 모든 계정 열쇠를 포함합니다.

### CLI

저장된 CLI 액세스를 사용하십시오. 이름의 프로필에 --profile NAME을 각 명령에 추가합니다. 이 읽기는 쿼리 크레딧을 사용하지 않습니다.

#### 무료 계정 읽기

```bash
flashdata account usage
```

- [키 설정](https://flashdata.dev/ko/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

동일한 맨끝에 있는 이른 체크에서 FLASHDATA_API_KEY를 재사용하십시오.

#### 계정 읽기 JSON

```bash
(
: "${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/usage' || exit
printf '\n'
)
```


### PowerShell 7

동일한 맨끝에 있는 이른 체크에서 FLASHDATA_API_KEY를 재사용하십시오.

#### 계정 읽기 JSON

```powershell
& {
  $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/usage"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```



<a id="usage-result"></a>

### 완료된 작업 및 크레딧 확인

총과 bySource를 읽으십시오, 그 후에 당신의 작업 기록과 비교하십시오. CLI JSON는 자료에 있는 응답을 포장합니다. 최근의 요청 또는 환불은 false가 될 때도 나타나는 시간이 걸릴 수 있습니다.

#### 일러스트레이션 응답 excerpt

```json
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}
```

- [History에서 작업 검사](https://flashdata.dev/app/jobs)
- [자주 묻는 질문](https://flashdata.dev/ko/docs/guides/credits-and-billing/reference.md)

<a id="usage-filter"></a>

### 소스 및 날짜 범위 필터

최대 31일의 보고 기간을 가진 UTC 날짜를 대체하십시오. from is 포괄적이고 독점하기 위하여; 둘 다 분으로 돌진됩니다. 이것은 기존의 사용만을 읽습니다.

#### 예고편 보기

```bash
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"
```

