Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Menetapkan Tugas ‘LLM Responses ChatGPT’

Felo API Support
MIT
Pelayan:https://openapi.felo.ai
Pustaka Klien
Shell Curl

DataForSEO

​

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

DataForSEO Operasi

Menetapkan Tugas ‘LLM Responses ChatGPT’

​

Masukkan prompt ChatGPT ke dalam baris gilir dan bukan menunggu balasan, memulangkan id tugas. Menambah system_message dan message_chain berbanding endpoint langsung, jadi perbualan berbilang giliran boleh dihantar dalam satu tugas. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. ⚠️ Bukan semua model menyokong baris gilir - periksa task_post_supported dalam get_dataforseo_ai_chat_gpt_llm_responses_models. Ambil dengan get_dataforseo_ai_chat_gpt_llm_responses_fetch.

Rujukan harga

  • Pemeteran: Kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0.701.
  • 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.

Badan
application/json
  • Jenis: array (object | null)[]
    • force_web_search
      Jenis: boolean | null

      paksa agen AI menggunakan carian web
      medan pilihan
      untuk mendayakan parameter ini, web_search juga mesti didayakan;
      apabila didayakan, model AI dipaksa mengakses dan memetik maklumat web semasa;
      nilai lalai: false;
      Nota: walaupun parameter ditetapkan kepada true, tiada jaminan sumber web akan dipetik dalam respons
      Nota #2: tidak disokong dalam model penaakulan

    • max_output_tokens
      Jenis: integer | null

      bilangan maksimum token dalam respons AI
      medan pilihan
      nilai minimum untuk model penaakulan (contohnya, reasoning ialah true dalam endpoint Models): 1024;
      nilai minimum untuk model bukan penaakulan: 16;
      nilai maksimum: 4096;
      nilai lalai: 2048

    • message_chain
      Jenis: array (object | null)[] | null

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

      • message
        Jenis: string | null

        teks mesej

      • role
        Jenis: string | null

        peranan pengguna asal mesej

    • model_name
      Jenis: string

      nama model AI
      medan wajib
      model_nameterdiri daripada nama model sebenar dan nama versi;
      jika nama model asas ditentukan, versi terbaharunya akan ditetapkan secara lalai;
      contohnya, jika gpt-4.1 ditentukan, gpt-4.1-2025-04-14 akan ditetapkan sebagai model_name secara automatik;
      anda boleh mendapatkan senarai model LLM tersedia dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models

    • pingback_url
      Jenis: string | null

      URL pemberitahuan tugas yang selesai
      medan pilihan
      apabila tugas selesai, kami akan memberitahu anda melalui permintaan GET yang dihantar ke URL yang anda tentukan
      anda boleh menggunakan string ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag berkod URL. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan
      contoh:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Nota: aksara khas dalam pingback_url akan dikodkan URL;
      iaitu, aksara # akan dikodkan menjadi %23

      ketahui lebih lanjut di Pusat Bantuan kami

    • postback_url
      Jenis: string | null

      URL untuk menghantar hasil tugas
      medan pilihan
      sebaik sahaja tugas selesai, kami akan menghantar permintaan POST dengan hasilnya yang dimampatkan dalam format gzip ke postback_url yang anda tentukan
      anda boleh menggunakan string ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag berkod URL. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
      contoh:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Nota: aksara khas dalam postback_url akan dikodkan URL;
      iaitu, aksara # akan dikodkan menjadi %23

      ketahui lebih lanjut di Pusat Bantuan kami

    • system_message
      Jenis: string | null

      arahan untuk tingkah laku AI
      medan pilihan
      menentukan peranan, nada atau tingkah laku khusus AI;
      anda boleh menentukan sehingga 500 aksara dalam medan system_message

    • tag
      Jenis: 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 nilai tag yang ditentukan dalam array data respons

    • temperature
      Jenis: 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

    • top_p
      Jenis: number | null

      kepelbagaian respons AI
      medan pilihan
      mengawal kepelbagaian respons dengan mengehadkan pemilihan token;
      nilai minimum: 0
      nilai maksimum: 1
      nilai lalai: 0.92

      Nota: top_p tidak boleh digunakan bersama temperature dalam permintaan yang sama

    • user_prompt
      Jenis: string

      prompt untuk model AI
      medan wajib
      soalan atau tugas yang ingin anda hantar kepada model AI;
      anda boleh menentukan sehingga 500 aksara dalam medan user_prompt

    • web_search
      Jenis: boolean | null

      dayakan carian web
      medan pilihan
      apabila didayakan, model AI boleh mengakses dan memetik maklumat web semasa;
      nilai lalai: false;
      Nota: rujuk endpoint Models untuk senarai model yang menyokong web_search;

    • web_search_city
      Jenis: string | null

      nama bandar lokasi
      medan pilihan
      Nota: tidak disokong dalam model o3-mini, o1-pro, o1

    • web_search_country_iso_code
      Jenis: string | null

      kod negara ISO lokasi
      medan pilihan
      untuk mendayakan parameter ini, web_search juga mesti didayakan;
      apabila didayakan, model AI akan mencari di web dari negara yang anda tentukan;
      Nota: tidak disokong dalam model o3-mini, o1-pro, o1

Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesTaskPostResponseInfo
    • cost
      Jenis: number | null Format: double

      jumlah kos tugas, USD

    • status_code
      Jenis: integer | null

      kod status umum; anda boleh menemui senarai penuh kod respons di sini

    • status_message
      Jenis: string | null

      mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

    • tasks
      Jenis: array (object | null)[] | null

      tatasusunan tugas

      • Jenis: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesTaskPostTaskInfo
        • cost
          Jenis: number | null Format: double

          jumlah kos tugas, USD

        • data
          Jenis: object | null

          mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

          • propertyName
            Jenis: object | null
        • id
          Jenis: string | null

          pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

        • path
          Jenis: array (string | null)[] | null

          Laluan URL

        • result
          Jenis: object | null

          tatasusunan hasil
          dalam kes ini, nilainya akan menjadi null

        • result_count
          Jenis: integer | null Format: int64

          bilangan elemen dalam array hasil

        • status_code
          Jenis: integer | null

          kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

        • status_message
          Jenis: string | null

          mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

        • time
          Jenis: string | null

          masa pelaksanaan, saat

    • tasks_count
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks

    • tasks_error
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks yang dipulangkan dengan ralat

    • time
      Jenis: string | null

      jumlah masa pelaksanaan, saat

    • version
      Jenis: string | null

      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
Request Example for post/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_responses/task_post
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
    }
  ]
}

Operasi berjaya

Setting ‘LLM Responses ChatGPT’ Tasks