v0.2.0-beta

OpenAPI 3.1.0

Risposte LLM Claude live

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

Risposte LLM Claude live

Invia un user_prompt a un modello Claude in modo sincrono e restituisce la risposta. model_name deve provenire da get_dataforseo_ai_claude_llm_responses_models – i nomi sono simili a claude-sonnet-5, e un'ipotesi plausibile viene rifiutata. Restituisce model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items e fan_out_queries. Leggi money_spent nella risposta per vedere quanto è costato davvero un prompt. Racchiuso nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code – una richiesta rifiutata restituisce comunque HTTP 200.

Riferimento prezzi

Misurazione: costo della risposta comunicato.
Stima di riferimento per richiesta: USD 0.0567.
Moltiplicatore di riferimento per il cliente: 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 garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Corpo

application/json

Tipo: array (object | null)[]
- force_web_search
  Tipo: boolean | null
  
  forza l'agente AI a usare la ricerca web
  campo facoltativo
  per abilitare questo parametro, deve essere abilitato anche web_search;
  se abilitato, il modello AI è costretto ad accedere e citare informazioni web attuali;
  valore predefinito: false;
  Nota: anche se il parametro è impostato su true, non è garantito che le fonti web vengano citate nella risposta
- 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 è 1025
- 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 claude-opus-4-0, claude-opus-4-20250514 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/claude/llm_responses/models
- 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: 1
  valore predefinito: 0.7
  
  Nota: temperature non può essere usato insieme a top_p nella stessa richiesta
- 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: null
  
  Nota: top_p non può essere usato insieme a temperature nella stessa richiesta
- 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 è 1025
  Nota n. 2: se impostato su true, force_web_search deve essere impostato su false
  Nota n. 3: se impostato su true, temperature e top_p non possono essere usati
- 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
- web_search_city
  Tipo: string | null
  
  nome della città della località usata per la ricerca web
  campo facoltativo
- web_search_country_iso_code
  Tipo: string | null
  
  codice paese ISO della località usata per la ricerca web
  campo facoltativo
  valori possibili: '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'

Risposte

200
Tipo: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResponseInfo
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_AiOptimizationClaudeLlmResponsesLiveTaskInfo
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: array (object | null)[] | null

array di risultati

datetime
Tipo: string | null

data e ora di ricezione del risultato
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

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

array di query fan-out
contiene query di ricerca correlate derivate dalla query principale per fornire una risposta più completa

input_tokens
Tipo: integer | null

numero di token nell'input
conteggio totale dei token elaborati

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

array di elementi di risposta
contiene dati strutturati della risposta AI

type
Tipo: string | null

tipo di elemento

model_name
Tipo: string | null

nome del modello AI usato

money_spent
Tipo: number | null

costo dei token AI, USD
il prezzo addebitato dal provider terzo del modello AI secondo il suo Pricing

output_tokens
Tipo: integer | null

numero di token nell'output
conteggio totale dei token generati nella risposta AI

reasoning_tokens
Tipo: integer | null

numero di token di reasoning
conteggio totale dei token usati per generare contenuti di reasoning

web_search
Tipo: boolean | null

indica se è stata usata la ricerca web

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

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/claude/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,
    "model_name": "claude-opus-4-0",
    "temperature": 0.3,
    "web_search": true,
    "web_search_country_iso_code": "FR",
    "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": [
        {
          "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
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

Risposte LLM Claude live

AutenticazioneRequired

DataForSEO

Risposte LLM Claude live

Riferimento prezzi