# Python SDK быстрый старт

Установите Python SDK и распечатайте результаты поиска с помощью нескольких строк кода. Включает синхронные и асинхронные примеры.

Каноническая ссылка: https://flashdata.dev/ru/docs/guides/flashdata-python
Разработчик: 2026-11-04 by FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-python) — Источник: SDK reference
- [Получите 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+. Запустите эти команды в каталоге вашего проекта. Вы уже используете виртуальную среду? Установить flash-данные==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)
- [Открыть BillingQ](https://flashdata.dev/app/billing)
- [Пробная установка агента](https://flashdata.dev/ru/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 хиты: заголовок, ссылка и фрагмент. Другие источники имеют разные поля результатов. |
| 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 и возобновите существующие рабочие места после перезагрузки. |
| 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/ru/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" вместо этого отправляет фоновую работу на стороне сервера.

В Jupyter или приложении с запущенным циклом событий используйте ожидание main() вместо 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/ru/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 show flashdata (Windows: .\.venv\Scripts\python.exe -m pip show 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 | Используйте ожидание main() в блокноте или существующем цикле событий. Храните 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)
