v0.2.0-beta

OpenAPI 3.1.0

Taken voor 'LLM Responses Claude' instellen

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/claude/llm_responses/task_post

Taken voor 'LLM Responses Claude' instellen

Zet een Claude-prompt in de wachtrij in plaats van te wachten en retourneert een taak-id. Verpakt in de envelop van DataForSEO: gegevens in tasks[0].result, uitkomst in tasks[0].status_code - een geweigerd verzoek retourneert nog steeds HTTP 200. Controleer eerst task_post_supported in get_dataforseo_ai_claude_llm_responses_models en haal op met get_dataforseo_ai_claude_llm_responses_fetch.

Prijsreferentie

Meting: Gerapporteerde antwoordkosten.
Referentieschatting per verzoek: USD 0.701.
Referentiemultiplier voor klanten: 1.0. Pas deze niet opnieuw toe op een al 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
- max_output_tokens
  Type: integer | null
  
  maximaal aantal tokens in de AI-respons
  optioneel veld
  minimumwaarde: 1;
  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
  Let op #2: als use_reasoning op true staat, is de minimumwaarde voor max_output_tokens 1025
- 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 claude-opus-4-0 wordt opgegeven, wordt automatisch claude-opus-4-20250514 als model_name ingesteld;
  de lijst met beschikbare LLM-modellen ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models
- pingback_url
  Type: string | null
  
  meldings-URL van een voltooide taak
  optioneel veld
  wanneer een taak is voltooid, melden we je dit via een GET-verzoek naar de URL die je hebt opgegeven
  je kunt de tekenreeks ‘$id’ als $id-variabele en ‘$tag’ als URL-gecodeerde $tag-variabele gebruiken. We stellen de benodigde waarden in voordat we het verzoek versturen
  voorbeeld:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Let op: speciale tekens in pingback_url worden URL-gecodeerd;
  d.w.z. het teken # wordt gecodeerd als %23
  
  meer informatie vind je in ons Help Center
- postback_url
  Type: string | null
  
  URL voor het verzenden van taakresultaten
  optioneel veld
  zodra de taak is voltooid, sturen we een POST-verzoek met de resultaten gecomprimeerd in gzip-formaat naar de opgegeven postback_url
  je kunt de tekenreeks ‘$id’ als $id-variabele en ‘$tag’ als URL-gecodeerde $tag-variabele gebruiken. We stellen de benodigde waarden in voordat we het verzoek versturen.
  voorbeeld:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Let op: speciale tekens in postback_url worden URL-gecodeerd;
  d.w.z. het teken # wordt gecodeerd als %23
  
  meer informatie vind je in ons Help Center
- 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: 1
  standaardwaarde: 0.7
  
  Let op: temperature kan niet samen met top_p in hetzelfde verzoek worden gebruikt
- 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: null
  
  Let op: top_p kan niet samen met temperature in hetzelfde verzoek worden gebruikt
- use_reasoning
  Type: boolean | null
  
  reasoning voor het AI-model inschakelen
  optioneel veld
  indien ingeschakeld, voert het model reasoning uit voordat het een respons genereert
  raadpleeg het Models-endpoint voor een lijst met modellen die reasoning ondersteunen
  standaardwaarde: false
  Let op: als dit op true staat, is de minimumwaarde voor max_output_tokens 1025
  Let op #2: als dit op true staat, moet force_web_search op false staan
  Let op #3: als dit op true staat, kunnen temperature en top_p niet 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 voor actuele informatie inschakelen
  optioneel veld
  indien ingeschakeld, kan het AI-model actuele webinformatie raadplegen en citeren;
  Let op: raadpleeg het Models-endpoint voor een lijst met modellen die web_search ondersteunen;
  standaardwaarde: false;
  de kosten van de parameter kunnen worden berekend op de pagina Pricing
- web_search_city
  Type: string | null
  
  plaatsnaam van de locatie die voor de webzoekopdracht wordt gebruikt
  optioneel veld
- web_search_country_iso_code
  Type: string | null
  
  ISO-landcode van de locatie die voor de webzoekopdracht wordt gebruikt
  optioneel veld
  mogelijke waarden: 'AR','AT','AU','BE','BR','CA','CH','CL','CN','DE','DK','ES','FI','FR','GB','HK','ID','IN','IT','JP','KR','MX','MY','NL','NO','NZ','PH','PL','PT','RU','SA','SE','TR','TW','US','ZA'

Responsen

200
Type: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesTaskPostResponseInfo
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_AiOptimizationClaudeLlmResponsesTaskPostTaskInfo
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: object | null

array van resultaten
in dit geval is de waarde null

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/claude/llm_responses/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/claude/llm_responses/task_post \
  --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": 1024,
    "temperature": 0.3,
    "web_search_country_iso_code": "FR",
    "model_name": "claude-sonnet-4-0",
    "web_search": true,
    "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": null
    }
  ]
}

Geslaagde bewerking

Taken voor 'LLM Responses Claude' instellen

AuthenticatieRequired

DataForSEO

Taken voor 'LLM Responses Claude' instellen

Prijsreferentie