SDKs
Python
Patterns Python idiomatiques pour la Thunderbit Open API
Les SDKs officiels arrivent. En attendant, l'API Thunderbit est une simple surface REST HTTP/JSON — httpx (ou requests) suffit largement.
Installation
pip install httpxConfiguration
import httpx, os
API = "https://openapi.thunderbit.com/openapi/v1"
H = {"Authorization": f"Bearer {os.environ['THUNDERBIT_API_KEY']}"}
client = httpx.Client(base_url=API, headers=H, timeout=60.0)Distill une page
resp = client.post("/distill", json={"url": "https://thunderbit.com/playground"})
resp.raise_for_status()
print(resp.json()["data"]["markdown"])Extract de données structurées
resp = client.post("/extract", json={
"url": "https://example.com/product/iphone-15-pro",
"schema": {
"type": "object",
"properties": {
"name": {"type": "string"},
"price": {"type": "number"},
},
"required": ["name", "price"],
},
})
print(resp.json()["data"])Async
Pour les pipelines à fort débit, passe à httpx.AsyncClient :
import asyncio, httpx
async def distill_many(urls: list[str]):
async with httpx.AsyncClient(headers=H, timeout=60.0) as client:
tasks = [client.post(f"{API}/distill", json={"url": u}) for u in urls]
resps = await asyncio.gather(*tasks)
return [r.json()["data"]["markdown"] for r in resps]Pour plus de ~10 URLs, préfère /batch/distill plutôt que d'éclater en appels unitaires — voir Cycle de vie des batch jobs.
Un SDK Python officiel est en développement — reviens bientôt.