Impostare le attività ‘LLM Responses ChatGPT’
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Impostare le attività ‘LLM Responses ChatGPT’
Mette in coda un prompt ChatGPT invece di attendere la risposta, restituendo un id di attività. Aggiunge system_message e message_chain rispetto all'endpoint live, così una conversazione a più turni può essere inviata in un'unica attività. Racchiuso nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code – una richiesta rifiutata restituisce comunque HTTP 200. ⚠️ Non tutti i modelli supportano la coda – controlla task_post_supported in get_dataforseo_ai_chat_gpt_llm_responses_models. Recupera con get_dataforseo_ai_chat_gpt_llm_responses_fetch.
Riferimento prezzi
- Misurazione: costo della risposta comunicato.
- Stima di riferimento per richiesta: USD 0.701.
- 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.
- Tipo: array (object | null)[]
- forceTipo: boolean | null
_web _search forza l'agente AI a usare la ricerca web
campo facoltativo
per abilitare questo parametro, deve essere abilitato ancheweb_search;
se abilitato, il modello AI è costretto ad accedere e citare informazioni web attuali;
valore predefinito:false;
Nota: anche se il parametro è impostato sutrue, non è garantito che le fonti web vengano citate nella risposta
Nota n. 2: non supportato nei modelli di ragionamento - maxTipo: integer | null
_output _tokens - messageTipo: array (object | null)[] | null
_chain 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?"}]
- messageTipo: string | null
testo del messaggio
- roleTipo: string | null
ruolo dell'utente da cui proviene il messaggio
- modelTipo: string
_name nome del modello AI
campo obbligatoriomodel_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 specificatogpt-4.1,gpt-4.1-2025-04-14verrà impostato automaticamente comemodel_name;
puoi ottenere l'elenco dei modelli LLM disponibili effettuando una richiesta separata ahttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models - pingbackTipo: string | null
_url 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$ide ‘$tag’ come variabile$tagcodificata per URL. Imposteremo i valori necessari prima di inviare la richiesta
esempio:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Nota: i caratteri speciali inpingback_urlvengono codificati per URL;
ad es. il carattere#viene codificato in%23 - postbackTipo: string | null
_url URL per l'invio dei risultati dell'attività
campo facoltativo
una volta completata l'attività, invieremo una richiesta POST con i risultati compressi in formatogzipalpostback_urlspecificato
puoi usare la stringa ‘$id’ come variabile$ide ‘$tag’ come variabile$tagcodificata per URL. Imposteremo i valori necessari prima di inviare la richiesta.
esempio:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Nota: i caratteri speciali inpostback_urlvengono codificati per URL;
ad es. il carattere#viene codificato in%23 - systemTipo: string | null
_message 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 camposystem_message - tagTipo: 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 valoretagspecificato si trova nell'arraydatadella risposta - temperatureTipo: 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:0.94
Nota: non supportato nei modelli di ragionamento - topTipo: number | null
_p 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.92Nota:
top_pnon può essere usato insieme atemperaturenella stessa richiesta - userTipo: string
_prompt 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 campouser_prompt - webTipo: boolean | null
_search - webTipo: string | null
_search _city nome della città della località
campo facoltativo
Nota: non supportato nei modellio3-mini,o1-proeo1 - webTipo: string | null
_search _country _iso _code codice paese ISO della località
campo facoltativo
per abilitare questo parametro, deve essere abilitato ancheweb_search;
se abilitato, il modello AI cerca sul web dal paese specificato;
Nota: non supportato nei modellio3-mini,o1-proeo1
- Tipo: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesTaskPostResponseInfo200
- Tipo: number | null Formato: doublecost
Costo totale delle attività, USD
- Tipo: integer | nullstatus
_code codice di stato generale l'elenco completo dei codici di risposta è disponibile qui
- Tipo: string | nullstatus
_message messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui
- Tipo: array (object | null)[] | nulltasks
array di attività
- Tipo: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesTaskPostTaskInfo
- costTipo: number | null Formato: double
Costo totale delle attività, USD
- dataTipo: object | null
Contiene gli stessi parametri specificati nella richiesta POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID
- pathTipo: array (string | null)[] | null
Percorso URL
- resultTipo: object | null
array di risultati
in questo caso il valore sarànull - resultTipo: integer | null Formato: int64
_count Numero di elementi nell'array dei risultati
- statusTipo: integer | null
_code codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui
- statusTipo: string | null
_message messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui
- timeTipo: string | null
Tempo di esecuzione in secondi
- Tipo: integer | null Formato: int64tasks
_count Il numero di attività nell'array tasks
- Tipo: integer | null Formato: int64tasks
_error Il numero di attività nell'array tasks restituite con un errore
- Tipo: string | nulltime
tempo di esecuzione totale, secondi
- Tipo: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/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": "gpt-4.1-mini",
"user_prompt": "provide information on how relevant the amusement park business is in France now"
}
]'
{
"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
}
]
}