# Python SDK 퀵스타트

Python SDK를 설치하고 몇 줄의 코드로 검색 결과를 인쇄합니다. 비동기 및 asyncio 예제를 포함합니다.

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

- [GitHub](https://github.com/flashdatadev/flashdata-python) — 소스 및 SDK 참조
- [API 키 받기](https://flashdata.dev/app/api-keys) — 콘솔에서 키 만들기

<a id="application"></a>

## 첫 번째 Python 요청 확인

SDK를 설치하고 API 키를 설정하고 하나의 검색을 실행합니다. 응답은 기본적으로 Python 사전입니다.

- [Python SDK 참조](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)
- [PyPI](https://pypi.org/project/flashdata/1.1.0/)

<a id="install"></a>

### SDK 설치

Python 3.10+를 요구합니다. 프로젝트 디렉토리에서 이러한 명령을 실행합니다. 가상 환경을 사용하는 이미? 그 환경의 python -m pip 대신에 flashdata==1.1.0를 설치하십시오.

#### Linux / macOS

##### 설치

```bash
python3 -m venv .venv
.venv/bin/python -m pip install "flashdata==1.1.0"
```


#### Windows PowerShell

##### 설치

```powershell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"
```


- [Python 설치](https://www.python.org/downloads/)

<a id="key"></a>

### 인증현황

Google Search 권한으로 API 키 생성, 또는 승인된 키를 재사용합니다. 아래 숨겨진 프롬프트를 사용하여이 터미널에서 설정하십시오.

FLASHDATA_API_KEY가 이미 설정된 경우 프롬프트를 건너 뛸 수 있습니다. 이 예제는 변수를 직접 읽습니다. 그들은 .env 파일을로드하지 않습니다.

#### Bash

##### 숨겨진 키 프롬프트 · Bash

```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
```


#### PowerShell 7

##### 숨겨진 키 프롬프트 · PowerShell

```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
```


- [가입](https://flashdata.dev/signup)
- [API Keys 열기](https://flashdata.dev/app/api-keys)
- [오픈 Billing](https://flashdata.dev/app/billing)
- [Agent 평가 설정](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md)

<a id="query"></a>

### 검색 실행

quickstart.py로 이것을 저장하고, 그런 가상 환경으로 실행하십시오. 그것은 최대 5개의 결과 및 인쇄 제목, URLs 및 사용 신용을 위한 1개의 Google Search 요구에 응합니다.

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.search("battery recycling research", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for hit in page.get("organic", []):
            print(hit["title"], hit["link"])
    print("Credits used:", response["usage"]["credits"])
```

#### Linux / macOS

##### 실행

```bash
.venv/bin/python quickstart.py
```


#### Windows PowerShell

##### 실행

```powershell
.\.venv\Scripts\python.exe quickstart.py
```



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

### 결과 확인

상태 확인 후 일반적으로 스크립트 종료가 완료됩니다. 예상 소스 제목과 URLs 다음 크레딧 사용. 빈 유기 목록은 유효한 응답입니다; 결과는 당신의 질문과 변화합니다.

| - 연혁 | 제품 정보 |
| --- | --- |
| results[].organic[] | Google Search 조회: 제목, 링크 및 스니펫. 다른 소스에는 다른 결과 필드가 있습니다. |
| usage.credits | 이 요청의 비용. 최대 5개의 결과가 하나의 검색 요청입니다. |

#### 예 출력

```text
Battery recycling research https://example.org/recycling
Credits used: 0.02
```


<a id="common-tasks"></a>

## 다른 데이터 소스를 시도

각 탭은 완전한 스크립트입니다. quickstart.py를 하나의 예로 바꾸고 단계 3에서 명령으로 실행하십시오. 각 실행은 하나의 새로운 요청을 제출합니다. 키는 소스 권한이 표시됩니다.

### Google 뉴스

google_news를 요구합니다. results[].news[]에서 기사 제목 및 소스 링크 인쇄.

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.news("battery recycling", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for article in page.get("news", []):
            print(article.get("title"), article.get("link"))
```


### YouTube 메타데이터

youtube_metadata를 요구합니다. 비디오 제목, 채널 및 기간을 초에 인쇄합니다. 검사를 원하신다면 비디오 ID를 교체하십시오.

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.youtube.metadata("dQw4w9WgXcQ", include_formats=False)
    if response["status"] != "done":
        raise RuntimeError(response)
    for video in response["results"]:
        print(video.get("title"), video.get("channel"))
        print("Seconds:", video.get("duration"))
```


### YouTube 성적표

youtube_transcript를 요구합니다. results[].fullText.의 기존 영어 자동 성적표 인쇄 비디오는 트랙을 가지고 있어야한다; 이 호출은 생성하거나 캡션을 번역하지 않습니다.

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.youtube.transcript("dQw4w9WgXcQ", language="en", auto=True)
    if response["status"] != "done":
        raise RuntimeError(response)
    for track in response["results"]:
        print(track.get("fullText", ""))
```


- [모든 소스 방법 및 매개 변수](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/sources/index.md)

<a id="features"></a>

## Python SDK 지원

| 제품 정보 | SDK 항목 포인트 |
| --- | --- |
| google / youtube | Google Search, 뉴스, 이미지, 쇼핑, 비디오 및 장소; YouTube discovery, 메타데이터, 캡션, 성적표 및 채널 데이터. |
| youtube.download | 오디오 또는 비디오 배달 작업을 클라우드 스토리지에 제출하십시오. youtube_download 권한 및 저장 구성이 필요합니다. 아래의 전체 다운로드 예제를 따르십시오. |
| jobs / bulk | 받아 들여지는 일을 저장 ID, 완료 및 검색 결과 기다립니다. 더 큰 비디오-ID 데이터 세트에 대 한 대량 사용 하 고 재시작 후 기존 작업을 재시작 합니다. |
| account | 복구 작업 전에 액세스, 균형, 가격, 제한 및 사용 읽으십시오. 당신의 환경 또는 비밀 상점에서 허가한 열쇠를 재사용하십시오. |
| respond_with / accept | respond_with="markdown"를 Markdown에 대응["content"], 혹은 accept="text/plain"를 문자열로 사용합니다. JSON 사전은 기본값입니다. |

- [Python 다운로드 예](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/examples/youtube_download.py)
- [다운로드 구성](https://flashdata.dev/ko/docs/guides/youtube-download-guide/reference.md)
- [Python 응답 체재](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/response-formats.md)

<a id="asyncio"></a>

## asyncio 사용

이 버전으로 quickstart.py를 대체하고 동일한 실행 명령을 사용합니다. AsyncFlashData는 같은 리소스를 기다립니다. 실시간 검색 응답을 위해 여전히 대기; mode="async" 대신 서버 측 배경 작업을 제출합니다.

Jupyter 또는 실행 이벤트 루프가있는 응용 프로그램에서 asyncio.run (main) 대신 메인 ()을 사용하십시오. 해당 이벤트 루프 내에서 클라이언트를 재사용합니다.

### quickstart.py

```python
import asyncio
import os
from flashdata import AsyncFlashData

async def main():
    async with AsyncFlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = await client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])

asyncio.run(main())
```

- [Async 클라이언트 구성](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/client.md)

<a id="next"></a>

## 다음 단계

- [계정 확인 및 저장된 결과](https://flashdata.dev/ko/docs/guides/sdk-operations/reference.md)
- [배경 작업 및 배치](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/jobs.md)
- [Bulk 데이터셋](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/bulk.md)
- [SDK 방법 참고](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)

<a id="errors"></a>

## 단계가 실패한 경우

| 의 의 | 해결 |
| --- | --- |
| ModuleNotFoundError | 동일한 해석기로 설치하고 실행하십시오: .venv/bin/python -m pip 쇼 flashdata (Windows: .\.venv\Scripts\python.exe -m pip 쇼 flashdata). 스크립트 flashdata.py 이름을 지정하지 마십시오. |
| KeyError: FLASHDATA_API_KEY / 401 | 동일한 맨끝에 있는 활동적인 API 열쇠를 놓으십시오. .env 파일은 혼자이 예제에 의해로드되지 않습니다. API 키는 MCP OAuth 토큰이 아닙니다. |
| 403 | 이 키의 예에 의해 필요한 소스 권한을 부여합니다. |
| 402 | Billing를 확인하여 사용 가능한 크레딧을 확인하세요. 시험 접근이 소진되면 계정 잔액을 사용하는 연결이 청구됩니다. |
| 429 / APIError | error.retry_after를 검사하고 요구 비율을 감소시키십시오. SDK는 각 요청을 한 번 보내고 자동으로 재발하지 않습니다. |
| SubmissionUnknownError | 제출은 이미 접수 될 수 있습니다. History를 반복하기 전에 확인하십시오. 사용 가능한 경우 ID를 저장하십시오. |
| asyncio.run() / running event loop | 사용은 노트북이나 기존의 이벤트 루프에서 메인()를 기다립니다. 독립 스크립트를 위해 asyncio.run(main())를 유지하십시오. |

- [회사연혁](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [Python 오류 및 복구](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/errors.md)
