Limieten, kosten en best practices
Op deze pagina
Zoekverantwoordelijkheid
Het beheersen van de zoekmogelijkheden van de Grok API is niet genoeg. U moet ook de technische limieten begrijpen, productiekosten anticiperen en best practices toepassen om betrouwbare, kosteneffectieve applicaties te bouwen.
Kostenstructuur
De facturatie voor zoeken is gebaseerd op twee verschillende componenten:
Kosten per tool-aanroep
Elke aanroep van web_search of x_search kost $5 per 1.000 aanroepen, oftewel $0,005 per aanroep. Deze kosten zijn vast, ongeacht het aantal teruggegeven resultaten of de complexiteit van de zoekopdracht.
Tokenkosten
Naast de aanroepkosten worden input- en outputtokens normaal gefactureerd. Zoekresultaten die in de modelcontext worden geïnjecteerd, verhogen het verbruik van inputtokens. Gedetailleerde antwoorden met citaten verhogen het aantal outputtokens.
Budgetraming
Voor een dagelijkse monitoringapplicatie die 5 onderwerpen volgt:
Zoekopdrachten per dag:
5 onderwerpen x 2 tools (web + X) = 10 aanroepen
10 x $0,005 = $0,05/dag
Tokens per zoekopdracht (schatting):
~2.000 inputtokens + ~1.000 outputtokens = ~3.000 tokens
10 zoekopdrachten x 3.000 tokens ≈ 30.000 tokens/dag
Maandelijks budget:
Aanroepen: $0,05 x 30 = $1,50
Tokens: variabel, afhankelijk van het gebruikte model
Geschat totaal: $5–$15/maand, afhankelijk van de uitgebreidheid
Technische beperkingen
Actualiteit van resultaten
Webzoekopdrachten leveren recente resultaten op, maar er kan vertraging optreden tussen de publicatie van inhoud en de indexering door de zoekmachine van xAI. Voor lopende gebeurtenissen is X over het algemeen responsiever dan het web.
Taaldekking
Resultaten zijn beter in het Engels dan in het Frans of andere talen. Formuleer bij zoekopdrachten in het Frans de prompt in het Frans, maar houd er rekening mee dat Engelstalige bronnen vaak oververtegenwoordigd zullen zijn.
Zoekdiepte
Het model crawlt niet het hele web. Het bevraagt een zoekmachine en analyseert de topresultaten. Voor niche-onderwerpen kunnen de resultaten beperkt zijn.
Betrouwbaarheid van citaten
Citaties zijn automatisch maar niet onfeilbaar. Een URL kan van inhoud zijn veranderd tussen het moment van zoeken en de raadpleging door de gebruiker. Verifieer links altijd voordat u ze opneemt in officiële documenten.
Best practices voor ontwikkeling
Fouten en randgevallen afhandelen
def recherche_robuste(query, max_retries=2):
for attempt in range(max_retries + 1):
try:
response = client.responses.create(
model="grok-4.5",
input=query,
tools=[{"type": "web_search"}],
timeout=30
)
if response.output_text:
return response.output_text
except Exception as e:
if attempt == max_retries:
return f"Search failed after {max_retries + 1} attempts: {e}"
return "No results obtained"
Resultaten cachen
Voor terugkerende query’s implementeert u een cache om redundante aanroepen te voorkomen:
from datetime import datetime, timedelta
cache = {}
def recherche_avec_cache(query, ttl_minutes=60):
now = datetime.now()
if query in cache:
result, timestamp = cache[query]
if now - timestamp < timedelta(minutes=ttl_minutes):
return result
result = client.responses.create(
model="grok-4.5",
input=query,
tools=[{"type": "web_search"}]
).output_text
cache[query] = (result, now)
return result
Prompts structureren voor zoeken
Goed gestructureerde prompts leveren betere zoekresultaten op:
- Wees specifiek: de query stuurt het model bij het kiezen van zoektermen
- Vraag om bronnen: het expliciet vermelden van citaten verbetert de opname ervan
- Stel het formaat in: een gestructureerd outputformaat vergemakkelijkt programmatisch gebruik
- Beperk de reikwijdte: een te brede reikwijdte verdunt de relevantie
Overbelasting van een enkele aanroep vermijden
Verzet u tegen de verleiding om alles in één prompt te vragen. Een aanroep die 10 verschillende analyses vraagt over 5 onderwerpen, levert oppervlakkige resultaten op. Geef de voorkeur aan meerdere gerichte aanroepen boven één massale aanroep.
Beveiliging en privacy
Gevoelige data in prompts
Verzoeken die naar de API worden verzonden, bevatten uw prompts. Verstuur geen vertrouwelijke gegevens in zoektermen. Als uw monitoring gevoelige onderwerpen bestrijkt (niet-openbare fusies en overnames, beveiligingslekken), formuleer dan query’s zonder interne informatie prijs te geven.
Ongefilterde resultaten
Zoekresultaten van het web en X worden niet gemodereerd door uw applicatie. Implementeer een filterlaag als resultaten direct aan eindgebruikers worden getoond, vooral in een professionele of educatieve context.
Checklist voor productie
Controleer voordat u een applicatie met Grok-zoeken implementeert het volgende:
- Heeft u de maandelijkse kosten voor aanroepen en tokens geraamd?
- Zijn uw time-outs aangepast voor zoekopdrachten (langer)?
- Handelt u netwerkfouten en lege antwoorden af?
- Heeft u een cache voor frequente query’s?
- Worden citaten geverifieerd voordat ze worden weergegeven?
- Is gevoelige data uitgesloten van prompts?
- Is er resultaatfiltering ingesteld voor eindgebruikers?
Praktijkoefening
Bouw een complete monitoringapplicatie die alle best practices uit deze les toepast: foutafhandeling, caching, kostenraming en citatieverificatie. Draai deze een week lang en meet de werkelijke kosten tegenover uw initiële schatting.
Belangrijkste punten
- Zoekkosten bedragen $5 per 1.000 aanroepen, plus verbruikte tokens
- De actualiteit van webresultaten kan variëren; X is responsiever voor direct nieuws
- Implementeer een cache voor terugkerende query’s om kosten te beheersen
- Handel fouten af en gebruik time-outs die zijn aangepast aan zoekopdrachten
- Verstuur geen vertrouwelijke gegevens in zoektermen
- Verifieer citaten altijd voordat u ze opneemt in officiële documenten
- Geef de voorkeur aan meerdere gerichte aanroepen boven één te ambitieuze aanroep
Test uw kennis
Web + X: Real-time zoeken met Grok, in vijf controles.
1. Wat maakt webzoeken mogelijk in de Grok API?
Antwoord: Webgebaseerde antwoorden op het moment van de query, met citaten—en controle via domeinfiltering om acceptabele bronnen af te bakenen.
2. Wat voegt X Search toe ten opzichte van webzoeken?
Antwoord: Toegang tot de conversationele real-time feed van X: posts, trends, zwakke signalen—filterbaar op handles en datums, terrein dat klassiek webzoeken niet bestrijkt.
3. Hoe exploiteert u citaten correct?
Antwoord: Door ze te verifiëren: het citaat bewijst herkomst, niet waarheid—ga voor fact-checking terug naar de bron en kruisverwijs meerdere referenties.
4. Noem twee typische use cases voor het combineren van Web + X.
Antwoord: Geautomatiseerde concurrentie-informatie (officiële aankondigingen op het web + reacties op X) en detectie van opkomende trends—elk kanaal vangt op wat het andere mist.
5. Welke limieten en best practices moet u in gedachten houden?
Antwoord: Zoekopdrachten hebben kosten per query: richt filters, beperk de diepte tot de werkelijke behoefte, en cach wat wordt hergebruikt—effectieve monitoring is scoped monitoring.
Gebronnde real-time data, beheerste filters, systematische verificatie: Grok-zoeken wordt een monitoringinstrument—geen orakel.