DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Respons ChatGPT LLM Langsung
Menghantar user_prompt kepada model ChatGPT dan memulangkan balasannya, secara segerak. model_name memilih model - lihat get_dataforseo_ai_chat_gpt_llm_responses_models, dan nama yang tidak tersenarai ditolak terus. max_output_tokens, temperature dan top_p berkelakuan seperti pada API vendor itu sendiri, dan web_search atau force_web_search membolehkannya melayari. Memulangkan model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items dan fan_out_queries. Baca money_spent pada respons untuk melihat kos sebenar sesuatu prompt. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. ⚠️ Ini ialah panggilan LLM umum yang dihalakan melalui penyedia data, bukan ukuran SEO. Jika anda ingin tahu apa yang ChatGPT beritahu pengguna tentang sesuatu jenama, post_dataforseo_ai_chat_gpt_llm_scraper_live menghasilkan semula pengalaman pengguna sebagai ganti.
Rujukan harga
- Pemeteran: Kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0.0695.
- Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.
Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.
- Jenis: array (object | null)[]
- forceJenis: boolean | null
_web _search paksa agen AI menggunakan carian web
medan pilihan
untuk mendayakan parameter ini,web_searchjuga mesti didayakan;
apabila didayakan, model AI dipaksa mengakses dan memetik maklumat web semasa;
nilai lalai:false;
Nota: walaupun parameter ditetapkan kepadatrue, tiada jaminan sumber web akan dipetik dalam respons
Nota #2: tidak disokong dalam model penaakulan - maxJenis: integer | null
_output _tokens bilangan maksimum token dalam respons AI
medan pilihan
nilai minimum untuk model penaakulan (contohnya,reasoningialahtruedalam endpoint Models):1024;
nilai minimum untuk model bukan penaakulan:16;
nilai maksimum:4096;
nilai lalai:2048
Nota: jikaweb_searchditetapkan kepadatrueatau model penaakulan ditentukan dalam permintaan, bilangan token output mungkin melebihi hadmax_output_tokensyang ditentukan - messageJenis: array (object | null)[] | null
_chain sejarah perbualan medan pilihan array objek mesej yang mewakili giliran perbualan sebelumnya; setiap objek mesti mengandungi: string role dengan peranan user atau ai; string message dengan kandungan mesej (maksimum 500 aksara); anda boleh menentukan maksimum 10 objek mesej dalam array; Nota: untuk model Perplexity, mesej mesti berselang-seli secara ketat antara peranan user dan AI (user → ai); contoh: "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?"}]
- messageJenis: string | null
teks mesej
- roleJenis: string | null
peranan pengguna asal mesej
- modelJenis: string
_name nama model AI
medan wajibmodel_nameterdiri daripada nama model sebenar dan nama versi;
jika nama model asas ditentukan, versi terbaharunya akan ditetapkan secara lalai;
contohnya, jikagpt-4.1ditentukan,gpt-4.1-2025-04-14akan ditetapkan sebagaimodel_namesecara automatik;
anda boleh mendapatkan senarai model LLM tersedia dengan membuat permintaan berasingan kehttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models - systemJenis: string | null
_message arahan untuk tingkah laku AI
medan pilihan
menentukan peranan, nada atau tingkah laku khusus AI
anda boleh menentukan sehingga 500 aksara dalam medansystem_message - tagJenis: string | null
pengecam tugas yang ditentukan pengguna
medan pilihan
had aksara ialah 255
anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil
anda akan menemui nilaitagyang ditentukan dalam objekdatarespons - temperatureJenis: number | null
kerawakan respons AI
medan pilihan
nilai lebih tinggi menjadikan output lebih pelbagai;
nilai lebih rendah menjadikan output lebih fokus;
nilai minimum:0
nilai maksimum:2
nilai lalai:0.94
Nota: tidak disokong dalam model penaakulan - topJenis: number | null
_p kepelbagaian respons AI
medan pilihan
mengawal kepelbagaian respons dengan mengehadkan pemilihan token;
nilai minimum:0
nilai maksimum:1
nilai lalai:0.92Nota:
top_ptidak boleh digunakan bersamatemperaturedalam permintaan yang sama - userJenis: string
_prompt prompt untuk model AI
medan wajib
soalan atau tugas yang ingin anda hantar kepada model AI;
anda boleh menentukan sehingga 500 aksara dalam medanuser_prompt - webJenis: boolean | null
_search - webJenis: string | null
_search _city nama bandar lokasi
medan pilihan
Nota: tidak disokong dalam modelo3-mini,o1-pro,o1 - webJenis: string | null
_search _country _iso _code kod negara ISO lokasi
medan pilihan
untuk mendayakan parameter ini,web_searchjuga mesti didayakan;
apabila didayakan, model AI akan mencari di web dari negara yang anda tentukan;
Nota: tidak disokong dalam modelo3-mini,o1-pro,o1
- Jenis: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResponseInfo200
- Jenis: number | null Format: doublecost
jumlah kos tugas, USD
- Jenis: integer | nullstatus
_code kod status umum; anda boleh menemui senarai penuh kod respons di sini
- Jenis: string | nullstatus
_message mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini
- Jenis: array (object | null)[] | nulltasks
tatasusunan tugas
- Jenis: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveTaskInfo
- costJenis: number | null Format: double
jumlah kos tugas, USD
- dataJenis: object | null
mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST
- propertyJenis: object | null
Name
- idJenis: string | null
pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID
- pathJenis: array (string | null)[] | null
Laluan URL
- resultJenis: array (object | null)[] | null
tatasusunan hasil
- datetimeJenis: string | null
tarikh dan masa hasil diterima
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:2019-11-15 12:57:46 +00:00 - fanJenis: array (string | null)[] | null
_out _queries array pertanyaan fan-out
mengandungi pertanyaan carian berkaitan yang diterbitkan daripada pertanyaan utama untuk memberikan respons yang lebih menyeluruh - inputJenis: integer | null
_tokens bilangan token dalam input
jumlah token yang diproses - itemsJenis: array (object | null)[] | null
array item respons
mengandungi data respons AI berstruktur- typeJenis: string | null
jenis elemen
- modelJenis: string | null
_name nama model AI yang digunakan
- moneyJenis: number | null
_spent - outputJenis: integer | null
_tokens bilangan token dalam output
jumlah token yang dijana dalam respons AI - reasoningJenis: integer | null
_tokens bilangan token penaakulan
jumlah token yang digunakan untuk menghasilkan kandungan penaakulan - webJenis: boolean | null
_search menunjukkan sama ada carian web digunakan
- resultJenis: integer | null Format: int64
_count bilangan elemen dalam array hasil
- statusJenis: integer | null
_code kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini
- statusJenis: string | null
_message mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini
- timeJenis: string | null
masa pelaksanaan, saat
- Jenis: integer | null Format: int64tasks
_count bilangan tugas dalam array tasks
- Jenis: integer | null Format: int64tasks
_error bilangan tugas dalam array tasks yang dipulangkan dengan ralat
- Jenis: string | nulltime
jumlah masa pelaksanaan, saat
- Jenis: string | nullversion
versi semasa API
application/json - 400
Permintaan tidak dapat diproses. Semak parameter permintaan.
- 401
Kunci API Felo yang sah diperlukan.
- 402
Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
- 403
Akaun tidak dibenarkan melakukan operasi ini.
- 429
Had permintaan atau had perbelanjaan telah dicapai.
- 502
Perkhidmatan tidak dapat menyelesaikan permintaan.
- 503
API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
- 504
Perkhidmatan tamat masa semasa memproses permintaan.
- default
Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/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,
"temperature": 0.3,
"top_p": 0.5,
"model_name": "gpt-4.1-mini",
"web_search": true,
"web_search_country_iso_code": "FR",
"web_search_city": "Paris",
"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": [
{
"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
]
}
]
}
]
}