# Python SDK szybki start

Zainstaluj Python SDK i wydrukuj wyniki wyszukiwania za pomocą kilku linii kodu. Obejmuje przykłady synchroniczne i asyncio.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/flashdata-python
Przegląd: 2026-11-04 przez FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-python) — Źródło i odniesienie do SDK
- [Uzyskaj klucz API](https://flashdata.dev/app/api-keys) — Utwórz klucz w konsoli

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

## Złóż pierwszą prośbę Python

Zainstaluj SDK, ustaw klawisz API i uruchom jedno wyszukiwanie. Odpowiedzi to domyślnie słowniki Python.

- [Python SDK odniesienia](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>

### Zainstaluj SDK

Wymaga Python 3.10 +. Uruchom te polecenia w katalogu projektu. Już używasz wirtualnego środowiska? Zainstaluj flashdata = = 1.1.0 z tym pytonem środowiska -m pip zamiast.

#### Linux / macOS

##### Zainstaluj

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


#### Windows PowerShell

##### Zainstaluj

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


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

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

### Uwierzytelnij

Utwórz klucz API za zgodą Google Search lub ponownie użyj autoryzowanego klucza. Ustaw go w tym terminalu za pomocą ukrytego sygnału poniżej.

Pomiń polecenie, jeśli FLASHDATA_API_KEY jest już ustawiony. Przykłady te odczytują bezpośrednio zmienną; nie ładują plików .env.

#### Bash

##### Ukryty sygnał klawiszowy · 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

##### Ukryty sygnał klawiszowy · 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
```


- [Zarejestruj się](https://flashdata.dev/signup)
- [Otwórz API Keys](https://flashdata.dev/app/api-keys)
- [Otwórz Billing](https://flashdata.dev/app/billing)
- [Ustawienie procesu agenta](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md)

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

### Wykonaj wyszukiwanie

Zapisz to jako quickstart.py, a następnie uruchom to z tym samym wirtualnym środowiskiem. Zrobi jeden wniosek Google Search dla maksymalnie pięciu wyników i wydruków tytułów, URLs i kredytów używanych.

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

##### Uruchom

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


#### Windows PowerShell

##### Uruchom

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



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

### Sprawdź wynik

Skrypt wychodzi normalnie po sprawdzeniu stanu jest gotowy. Oczekuj tytułów źródłowych i URLs, a następnie kredytów używanych. Pusta lista organicznych jest poprawną odpowiedzią; wyniki różnią się w zależności od zapytania.

| Pole | Stosowanie |
| --- | --- |
| results[].organic[] | Google Search hits: title, link and snippet. Inne źródła mają różne pola wyników. |
| usage.credits | Koszt tej prośby. Do pięciu wyników tutaj są jeden wniosek o wyszukiwanie. |

#### Przykład wyjścia

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


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

## Spróbuj innego źródła danych

Każda zakładka jest kompletnym skryptem. Zastąp quickstart.py jednym przykładem i uruchom go poleceniem z kroku 3. Każda runda składa jeden nowy wniosek; klucz wymaga pokazanego pozwolenia źródłowego.

### Google Aktualności

Wymaga google_news. Drukuje tytuły artykułów i linki źródłowe z 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"))
```


### Metadane YouTube

Wymaga youtube_metadata. Drukuje tytuł wideo, kanał i czas trwania w sekundach. Zastąp wideo ID jednym, który chcesz sprawdzić.

#### 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"))
```


### Transkrypcja YouTube

Wymaga youtube_transcript. Drukuje istniejący angielski automatyczny transkrypt z results[].fullText. Wideo musi mieć ten utwór; to wywołanie nie generuje ani nie przetłumacza napisów.

#### 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", ""))
```


- [Wszystkie metody i parametry źródłowe](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/sources/index.md)

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

## Co obsługuje Python SDK

| Stosowanie | Punkty wejścia SDK |
| --- | --- |
| google / youtube | Google Search, Aktualności, Zdjęcia, Zakupy, Filmy i Miejsca; Odkrycie YouTube, metadane, podpisy, transkrypcje i dane kanałowe. |
| youtube.download | Prześlij zadanie dostarczania dźwięku lub obrazu do pamięci masowej w chmurze. Wymaga uprawnień youtube_download i konfiguracji pamięci masowej; postępuj zgodnie z poniższym przykładem pobierania. |
| jobs / bulk | Zapisz przyjęte zadanie ID, czekaj na ukończenie i pobrać wyniki. Użyj luzem dla większych zbiorów danych wideo ID i wznowić istniejące zadania po ponownym uruchomieniu. |
| account | Odczyt dostępu, równowagi, cen, ograniczeń i wykorzystania przed powtarzającą się pracą. Ponownie użyj autoryzowanego klucza ze swojego środowiska lub tajnego sklepu. |
| respond_with / accept | Użyj respond_with = "markdown" dla Markdown w odpowiedzi ["content"] lub zaakceptuj = "text/plain" dla łańcucha. Słowniki JSON są domyślne. |

- [Kompletny przykład pobierania Python](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/examples/youtube_download.py)
- [Konfiguracja pamięci masowej pobierania](https://flashdata.dev/pl/docs/guides/youtube-download-guide/reference.md)
- [Formaty odpowiedzi Python](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/response-formats.md)

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

## Należy stosować asyncio

Zastąp quickstart.py tą wersją i użyj tej samej komendy. AsyncFlashData eksponuje te same zasoby oczekując. To nadal czeka na odpowiedź wyszukiwania w czasie rzeczywistym; mode="async" zamiast tego przedstawia zadanie w tle po stronie serwera.

W programie lub aplikacji z uruchomioną pętlą zdarzeń, zamiast asyncio.run (main () należy czekać na główny (). Ponownie użyj klienta w tej pętli zdarzeń.

### 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())
```

- [Konfiguracja klienta Async](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/client.md)

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

## Kolejne kroki

- [Kontrole rachunków i zapisane wyniki](https://flashdata.dev/pl/docs/guides/sdk-operations/reference.md)
- [Praca w tle i partia](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/jobs.md)
- [Zestawy danych Bulk](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/bulk.md)
- [Metoda odniesienia dla SDK](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)

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

## Jeśli krok zawiedzie

| Problem | Napraw |
| --- | --- |
| ModuleNotFoundError | Zainstaluj i uruchom z tym samym tłumaczem: .venv/bin/python -m pip wyświetla flashdata (Windows:.\ .venv\ Scripts\ python.exe -m pip pokazuje flashdata). Nie nazywaj skryptu flashdata.py. |
| KeyError: FLASHDATA_API_KEY / 401 | Ustaw aktywny klucz API w tym samym terminalu. Sam plik .env nie jest wczytany przez ten przykład. Użyj klawisza API, a nie symbolu MCP OAuth. |
| 403 | Udziel pozwolenia na korzystanie ze źródła wymaganego przez przykład tego klucza. |
| 402 | Sprawdź Billing dostępne kredyty. Jeśli dostęp do procesu jest wyczerpany, należy zażądać połączenia, aby skorzystać z Twojego konta. |
| 429 / APIError | Sprawdź error.retry_after i zmniejszyć stopę zapotrzebowania. SDK wysyła każde żądanie raz i nie próbuje ponownie automatycznie. |
| SubmissionUnknownError | Złożenie wniosku o wydanie orzeczenia może być już przyjęte. Zaznacz History przed powtórzeniem go; ponownie użyj zapisanego zadania ID, jeśli jest dostępny. |
| asyncio.run() / running event loop | Użyj czekać na główny () w notebooku lub istniejącej pętli zdarzeń. Zachowaj asyncio.run (main ()) dla skryptu samodzielnego. |

- [Poproś o historię](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [Błędy Python i odzysk](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/errors.md)
