# Python SDK швидкийстарт

Встановіть Python SDK і роздрукуйте результати пошуку з декількома лініями коду. Включає синхронні і асинхронні приклади.

Канонічне посилання: https://flashdata.dev/uk/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 dictionaries за замовчуванням.

- [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+. Запустіть ці команди в каталозі проекту. Уже використовуючи віртуальне середовище? Встановіть флешdata==1.1.0 з цим середовищем python -m pip замість цього.

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

### Ауттентицид

Створіть ключ API з дозволом Google Search або повторно використовуйте уповноважений ключ. Встановіть його в цей термінал за допомогою прихованого підказка нижче.

Пропустити запит, якщо 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)
- [Налаштування тестових випробувань агента](https://flashdata.dev/uk/docs/guides/agent-onboarding/reference.md)

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

### Виконайте пошук

Заощаджуйте це як quickstart.py, після чого запустіть його з таким же віртуальним середовищем. Це робить запит Google Search до п'яти результатів і друк назв, URLs і кредитних коштів, які використовуються.

#### 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 переглядів: назва, посилання та snippet. Інші джерела мають різні поля результатів. |
| usage.credits | Вартість цього запиту. До п'яти результатів тут є один запит на пошук. |

#### Приклад виходу

```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 відкриття, метадані, підписи, перезаписи та дані каналів. |
| youtube.download | Надайте аудіо або відео доставку на хмарне сховище. Вимагає дозвіл youtube_download і налаштування зберігання; слідувати за повним прикладом завантаження нижче. |
| jobs / bulk | Заощаджуйте прийнятий роботу ID, чекайте завершення та отримання результатів. Використовуйте сипучих для збільшення відео-ID datasets і відновлюють існуючі робочі місця після перезавантаження. |
| account | Читання доступу, баланс, ціноутворення, ліміти та використання перед рецидивною роботою. Змініть уповноважений ключ від вашого середовища або секретного магазину. |
| respond_with / accept | Використовуйте respond_with="markdown" для Markdown у відповідь["content"], або приймати="text/plain" для рядка. JSON є типовими. |

- [Повний приклад завантаження Python](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/examples/youtube_download.py)
- [Налаштування зберігання завантаження](https://flashdata.dev/uk/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>

## Використання асинхроніки

Замініть quickstart.py з цією версією і використовуйте команду запуску. AsyncFlashData виводить ті ж ресурси з очікуваним. Що ще чекає на відповідь на пошук в режимі реального часу; mode="async" подає серверну роботу замість роботи.

У Юпітері або аплікації з проточною петлею, використання чекає головний() замість asyncio.run(основний()). Зловживання клієнтом в межах цієї петлі заходу.

### 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/uk/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 шоу флешки (Windows: .\.venv\Scripts\python.exe -m pip шоу флешки). Не ім'я вашого скрипта 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 | Використовуйте expect main() в блокнот або існуючій петлі заходу. Зареєструватися asyncio.run(голова()) для самостійного сценарію. |

- [Історія запиту](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)
