v0.2.0-beta

OpenAPI 3.1.0

Live ChatGPT LLM-responsen

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operaties

post/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_responses/live

Live ChatGPT LLM-responsen

Stuurt een user_prompt synchroon naar een ChatGPT-model en retourneert het antwoord. model_name kiest het model – zie get_dataforseo_ai_chat_gpt_llm_responses_models; een niet-vermelde naam wordt direct geweigerd. max_output_tokens, temperature en top_p gedragen zich zoals in de API van de leverancier, en web_search of force_web_search laten het browsen. Retourneert model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items en fan_out_queries. Lees money_spent in de respons om te zien wat een prompt werkelijk kostte. Verpakt in de DataForSEO-envelop: gegevens in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. ⚠️ Dit is een algemene LLM-aanroep via een dataprovider, geen SEO-meting. Als je wilt weten wat ChatGPT gebruikers over een merk vertelt, reproduceert post_dataforseo_ai_chat_gpt_llm_scraper_live in plaats daarvan de consumentenervaring.

Prijsreferentie

Metering: Gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.0695.
Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body

application/json

Type: array (object | null)[]
- force_web_search
  Type: boolean | null
  
  AI-agent dwingen webzoekopdrachten te gebruiken
  optioneel veld
  om deze parameter in te schakelen, moet ook web_search zijn ingeschakeld;
  indien ingeschakeld, wordt het AI-model gedwongen actuele webinformatie te raadplegen en te citeren;
  standaardwaarde: false;
  Let op: zelfs als de parameter op true staat, is niet gegarandeerd dat webbronnen in de respons worden geciteerd
  Let op #2: niet ondersteund in reasoning-modellen
- max_output_tokens
  Type: integer | null
  
  maximaal aantal tokens in de AI-respons
  optioneel veld
  minimumwaarde voor reasoning-modellen (bijv. reasoning is true in het Models-endpoint): 1024;
  minimumwaarde voor niet-reasoning-modellen: 16;
  maximumwaarde: 4096;
  standaardwaarde: 2048
  Let op: als web_search op true staat of het reasoning-model in het verzoek is opgegeven, kan het aantal uitvoertokens de opgegeven limiet max_output_tokens overschrijden
- message_chain
  Type: array (object | null)[] | null
  
  gespreksgeschiedenis optioneel veld array met berichtobjecten die eerdere gespreksrondes vertegenwoordigen; elk object moet bevatten: role-string met de rol user of ai; message-string met de berichtinhoud (max. 500 tekens); je kunt maximaal 10 berichtobjecten in de array opgeven; Let op: bij Perplexity-modellen moeten berichten strikt afwisselen tussen user- en AI-rollen (user → ai); voorbeeld: "message_chain": [{"role":"user","message":"Hello, what’s up?"},{"role":"ai","message":"Hello! I’m doing well, thank you. How can I assist you today?"}]
  
  message
  Type: string | null
  
  berichttekst
  
  role
  Type: string | null
  
  rol van de gebruiker van wie het bericht afkomstig is
- model_name
  Type: string
  
  naam van het AI-model
  verplicht veld
  model_namebestaat uit de werkelijke modelnaam en versienaam;
  als de basisnaam van het model wordt opgegeven, wordt standaard de nieuwste versie gebruikt;
  als bijvoorbeeld gpt-4.1 wordt opgegeven, wordt automatisch gpt-4.1-2025-04-14 als model_name ingesteld;
  de lijst met beschikbare LLM-modellen ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models
- system_message
  Type: string | null
  
  instructies voor het gedrag van de AI
  optioneel veld
  bepaalt de rol, toon of het specifieke gedrag van de AI
  je kunt maximaal 500 tekens in het veld system_message opgeven
- tag
  Type: string | null
  
  door gebruiker gedefinieerde taak-ID
  optioneel veld
  de tekenslimiet is 255
  je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
  de opgegeven waarde tag vind je in het data-object van de respons
- temperature
  Type: number | null
  
  willekeur van de AI-respons
  optioneel veld
  hogere waarden maken de uitvoer gevarieerder;
  lagere waarden maken de uitvoer gerichter;
  minimumwaarde: 0
  maximumwaarde: 2
  standaardwaarde: 0.94
  Let op: niet ondersteund in reasoning-modellen
- top_p
  Type: number | null
  
  diversiteit van de AI-respons
  optioneel veld
  regelt de diversiteit van de respons door de tokenselectie te beperken;
  minimumwaarde: 0
  maximumwaarde: 1
  standaardwaarde: 0.92
  
  Let op: top_p kan niet samen met temperature in hetzelfde verzoek worden gebruikt
- user_prompt
  Type: string
  
  prompt voor het AI-model
  verplicht veld
  de vraag of taak die je naar het AI-model wilt sturen;
  je kunt maximaal 500 tekens in het veld user_prompt opgeven
- web_search
  Type: boolean | null
  
  webzoekopdrachten inschakelen
  optioneel veld
  indien ingeschakeld, kan het AI-model actuele webinformatie raadplegen en citeren;
  standaardwaarde: false;
  Let op: raadpleeg het Models-endpoint voor een lijst met modellen die web_search ondersteunen;
- web_search_city
  Type: string | null
  
  plaatsnaam van de locatie
  optioneel veld
  Let op: niet ondersteund in de modellen o3-mini, o1-pro en o1
- web_search_country_iso_code
  Type: string | null
  
  ISO-landcode van de locatie
  optioneel veld
  om deze parameter in te schakelen, moet ook web_search zijn ingeschakeld;
  indien ingeschakeld, zoekt het AI-model op het web vanuit het door jou opgegeven land;
  Let op: niet ondersteund in de modellen o3-mini, o1-pro en o1

Responsen

200
Type: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResponseInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

status_code
Type: integer | null

algemene statuscode de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

tasks
Type: array (object | null)[] | null

array van taken

Type: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveTaskInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

data
Type: object | null

Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

propertyName
Type: object | null
id
Type: string | null

taak-id eenduidige taak-id in ons systeem in UUID-indeling

path
Type: array (string | null)[] | null

URL-pad

result
Type: array (object | null)[] | null

array van resultaten

datetime
Type: string | null

datum en tijd waarop het resultaat is ontvangen
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

fan_out_queries
Type: array (string | null)[] | null

array van fan-out-query's
bevat gerelateerde zoekopdrachten die van de hoofdquery zijn afgeleid om een uitgebreider antwoord te geven

input_tokens
Type: integer | null

aantal tokens in de invoer
totaal aantal verwerkte tokens

items
Type: array (object | null)[] | null

array van responsitems
bevat gestructureerde AI-responsgegevens

type
Type: string | null

elementtype

model_name
Type: string | null

naam van het gebruikte AI-model

money_spent
Type: number | null

kosten van AI-tokens, USD
de prijs die de externe aanbieder van het AI-model in rekening brengt volgens zijn Pricing

output_tokens
Type: integer | null

aantal tokens in de uitvoer
totaal aantal tokens dat in de AI-respons is gegenereerd

reasoning_tokens
Type: integer | null

aantal reasoning-tokens
totaal aantal tokens dat is gebruikt om reasoning-inhoud te genereren

web_search
Type: boolean | null

geeft aan of webzoekopdracht is gebruikt

result_count
Type: integer | null Formaat: int64

Aantal elementen in de result-array

status_code
Type: integer | null

statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

time
Type: string | null

Uitvoeringstijd in seconden

tasks_count
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array

tasks_error
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array dat met een fout is geretourneerd

time
Type: string | null

totale uitvoeringstijd, seconden

version
Type: string | null

De huidige versie van de API
application/json
400

Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
401

Een geldige Felo-API-sleutel is vereist.
402

Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
403

Het account mag deze bewerking niet uitvoeren.
429

Een verzoek- of bestedingslimiet is bereikt.
502

De dienst kon het verzoek niet voltooien.
503

De API of factureringsdienst is tijdelijk niet beschikbaar.
504

Er is een time-out opgetreden bij het verwerken van het verzoek.
default

Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

application/json

post/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_responses/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_responses/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "system_message": "communicate as if we are in a business meeting",
    "message_chain": [
      {
        "role": "user",
        "message": "Hello, what’s up?"
      },
      {
        "role": "ai",
        "message": "Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?"
      }
    ],
    "max_output_tokens": 200,
    "temperature": 0.3,
    "top_p": 0.5,
    "model_name": "gpt-4.1-mini",
    "web_search": true,
    "web_search_country_iso_code": "FR",
    "web_search_city": "Paris",
    "user_prompt": "provide information on how relevant the amusement park business is in France now"
  }
]'

Schema tonen

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "model_name": null,
          "input_tokens": null,
          "output_tokens": null,
          "reasoning_tokens": null,
          "web_search": null,
          "money_spent": null,
          "datetime": null,
          "items": [
            {
              "type": null
            }
          ],
          "fan_out_queries": [
            null
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Live ChatGPT LLM-responsen

AuthenticatieRequired

DataForSEO

Live ChatGPT LLM-responsen

Prijsreferentie