v0.2.0-beta

OpenAPI 3.1.0

Impostare le attività di LLM Responses Gemini

Felo API Support

MIT

Server

https://openapi.felo.ai

Librerie client

Shell Curl

DataForSEO

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

DataForSEO Operazioni

post/v1/beta/dataforseo/ai_optimization/gemini/llm_responses/task_post

Impostare le attività di LLM Responses Gemini

Accoda un prompt Gemini invece di attendere e restituisce un id attività. Incapsulato nell'involucro di DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code - una richiesta rifiutata restituisce comunque HTTP 200. Verificare task_post_supported in get_dataforseo_ai_gemini_llm_responses_models e recuperare con get_dataforseo_ai_gemini_llm_responses_fetch.

Riferimento prezzi

Misurazione: costo della risposta comunicato.
Stima di riferimento per richiesta: USD 0.701.
Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account, né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Corpo

application/json

Tipo: array (object | null)[]
- max_output_tokens
  Tipo: integer | null
  
  numero massimo di token nella risposta AI
  campo facoltativo
  valore minimo: 1;
  valore massimo: 4096;
  valore predefinito: 2048;
  Nota: se web_search è impostato su true o nella richiesta è specificato il modello di ragionamento, il numero di token di output può superare il limite max_output_tokens specificato
  Nota n. 2: se use_reasoning è impostato su true, il valore minimo per max_output_tokens è 1024
- message_chain
  Tipo: array (object | null)[] | null
  
  cronologia della conversazione campo facoltativo array di oggetti messaggio che rappresentano turni di conversazione precedenti; ogni oggetto deve contenere: stringa role con il ruolo user o ai; stringa message con il contenuto del messaggio (max 500 caratteri); puoi specificare al massimo 10 oggetti messaggio nell'array; Nota: per i modelli Perplexity, i messaggi devono alternarsi rigorosamente tra i ruoli user e AI (user → ai); esempio: "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
  Tipo: string | null
  
  testo del messaggio
  
  role
  Tipo: string | null
  
  ruolo dell'utente da cui proviene il messaggio
- model_name
  Tipo: string
  
  nome del modello AI
  campo obbligatorio
  model_nameè composto dal nome effettivo del modello e dal nome della versione;
  se viene specificato il nome base del modello, per impostazione predefinita viene impostata la versione più recente;
  ad esempio, se viene specificato gemini-1.5-pro, gemini-1.5-pro-002 verrà impostato automaticamente come model_name;
  puoi ottenere l'elenco dei modelli LLM disponibili effettuando una richiesta separata a https://api.dataforseo.com/v3/ai_optimization/gemini/llm_responses/models
- pingback_url
  Tipo: string | null
  
  URL di notifica di un'attività completata
  campo facoltativo
  al completamento di un'attività ti invieremo una notifica tramite una richiesta GET all'URL specificato
  puoi usare la stringa ‘$id’ come variabile $id e ‘$tag’ come variabile $tag codificata per URL. Imposteremo i valori necessari prima di inviare la richiesta
  esempio:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Nota: i caratteri speciali in pingback_url vengono codificati per URL;
  ad es. il carattere # viene codificato in %23
  
  per saperne di più, consulta il nostro Help Center
- postback_url
  Tipo: string | null
  
  URL per l'invio dei risultati dell'attività
  campo facoltativo
  una volta completata l'attività, invieremo una richiesta POST con i risultati compressi in formato gzip al postback_url specificato
  puoi usare la stringa ‘$id’ come variabile $id e ‘$tag’ come variabile $tag codificata per URL. Imposteremo i valori necessari prima di inviare la richiesta.
  esempio:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Nota: i caratteri speciali in postback_url vengono codificati per URL;
  ad es. il carattere # viene codificato in %23
  
  per saperne di più, consulta il nostro Help Center
- system_message
  Tipo: string | null
  
  istruzioni per il comportamento dell'AI
  campo facoltativo
  definisce il ruolo, il tono o il comportamento specifico dell'AI
  puoi specificare fino a 500 caratteri nel campo system_message
- tag
  Tipo: string | null
  
  identificatore dell'attività definito dall'utente
  campo facoltativo
  il limite di caratteri è 255
  puoi usare questo parametro per identificare l'attività e associarla al risultato
  il valore tag specificato si trova nell'oggetto data della risposta
- temperature
  Tipo: number | null
  
  casualità della risposta AI
  campo facoltativo
  valori più alti rendono l'output più vario
  valori più bassi rendono l'output più mirato
  valore minimo: 0
  valore massimo: 2
  valore predefinito: 1.3
- top_p
  Tipo: number | null
  
  diversità della risposta AI
  campo facoltativo
  controlla la diversità della risposta limitando la selezione dei token
  valore minimo: 0
  valore massimo: 1
  valore predefinito: 0.9
- use_reasoning
  Tipo: boolean | null
  
  abilita il ragionamento per il modello AI
  campo facoltativo
  se abilitato, il modello esegue il ragionamento prima di generare una risposta
  consulta l'endpoint Models per un elenco dei modelli che supportano reasoning
  valore predefinito: false
  Nota: se impostato su true, il valore minimo per max_output_tokens è 1024
  Nota n. 2: per i modelli Gemini Pro, use_reasoning viene impostato automaticamente su true
- user_prompt
  Tipo: string
  
  prompt per il modello AI
  campo obbligatorio
  la domanda o l'attività che desideri inviare al modello AI;
  puoi specificare fino a 500 caratteri nel campo user_prompt
- web_search
  Tipo: boolean | null
  
  abilita la ricerca web per informazioni attuali
  campo facoltativo
  se abilitato, il modello AI può accedere e citare informazioni web attuali;
  Nota: consulta l'endpoint Models per un elenco dei modelli che supportano web_search;
  valore predefinito: false;
  il costo del parametro può essere calcolato nella pagina Pricing

Risposte

200
Tipo: object | null · Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostResponseInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

status_code
Tipo: integer | null

codice di stato generale l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui

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

array di attività

Tipo: object | null · Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostTaskInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

data
Tipo: object | null

Contiene gli stessi parametri specificati nella richiesta POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID

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

Percorso URL

result
Tipo: object | null

array di risultati
in questo caso il valore sarà null

result_count
Tipo: integer | null Formato: int64

Numero di elementi nell'array dei risultati

status_code
Tipo: integer | null

codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui

time
Tipo: string | null

Tempo di esecuzione in secondi

tasks_count
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks

tasks_error
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks restituite con un errore

time
Tipo: string | null

tempo di esecuzione totale, secondi

version
Tipo: string | null

La versione corrente dell'API
application/json
400

Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
401

È richiesta una chiave API Felo valida.
402

Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
403

L'account non è autorizzato a eseguire questa operazione.
429

È stato raggiunto un limite di richieste o di spesa.
502

Il servizio non è riuscito a completare la richiesta.
503

L'API o il servizio di fatturazione è temporaneamente non disponibile.
504

Si è verificato un timeout durante l'elaborazione della richiesta.
default

Risposta di errore; le risposte passthrough upstream possono usare formati del provider

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"
  }
]'

Mostra schema

{
  "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
    }
  ]
}

Operazione riuscita

Impostare le attività di LLM Responses Gemini

AutenticazioneRequired

DataForSEO

Impostare le attività di LLM Responses Gemini

Riferimento prezzi