v0.2.0-beta

OpenAPI 3.1.0

Taken voor 'LLM Responses Gemini' 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/gemini/llm_responses/task_post

Taken voor 'LLM Responses Gemini' instellen

Zet een Gemini-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 task_post_supported in get_dataforseo_ai_gemini_llm_responses_models en haal op met get_dataforseo_ai_gemini_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)[]
- 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 1024
- 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 gemini-1.5-pro wordt opgegeven, wordt automatisch gemini-1.5-pro-002 als model_name ingesteld;
  de lijst met beschikbare LLM-modellen ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/ai_optimization/gemini/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: 2
  standaardwaarde: 1.3
- 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.9
- 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 1024
  Let op #2: voor Gemini Pro-modellen wordt use_reasoning automatisch op true gezet
- 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

Responsen

200
Type: object | null · Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostResponseInfo
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_AiOptimizationGeminiLlmResponsesTaskPostTaskInfo
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/gemini/llm_responses/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/gemini/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?"
      }
    ],
    "model_name": "gemini-2.5-flash",
    "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 Gemini' instellen

AuthenticatieRequired

DataForSEO

Taken voor 'LLM Responses Gemini' instellen

Prijsreferentie