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

Perplexity LLM Responses Langsung

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

DataForSEO

​

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

DataForSEO Operasi

Perplexity LLM Responses Langsung

​

Mengirim user_prompt ke model Perplexity dan mengembalikan balasannya secara sinkron. model_name harus berasal dari get_dataforseo_ai_perplexity_llm_responses_models - sonar, sonar-pro, dan sonar-reasoning-pro. web_search_country_iso_code membatasi cakupan pencarian, yang tidak ditawarkan tiga vendor lainnya. Mengembalikan 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 biaya sebenarnya dari sebuah prompt. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200.

Referensi harga

  • Pengukuran: biaya respons yang dilaporkan.
  • Perkiraan permintaan referensi: USD 0,0163.
  • Pengali pelanggan referensi: 1,0. Jangan menerapkannya lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi
application/json
  • Tipe: array (object | null)[]
    • max_output_tokens
      Tipe: integer | null

      jumlah maksimum token dalam respons AI
      field opsional
      nilai minimum: 1
      nilai maksimum: 4096;
      nilai default: 2048;
      Catatan: jika model penalaran ditentukan dalam permintaan, jumlah token keluaran dapat melebihi batas max_output_tokens yang ditentukan

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

      riwayat percakapan field opsional array objek pesan yang mewakili giliran percakapan sebelumnya; setiap objek harus berisi: string role dengan peran user atau ai; string message dengan konten pesan (maksimum 500 karakter); Anda dapat menentukan maksimum 10 objek pesan dalam array; Catatan: untuk model Perplexity, pesan harus bergantian secara ketat antara peran 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
        Tipe: string | null

        teks pesan

      • role
        Tipe: string | null

        peran pengguna asal pesan

    • model_name
      Tipe: string

      nama model AI
      field wajib
      model_nameterdiri dari nama model sebenarnya dan nama versi;
      jika nama model dasar ditentukan, versi terbarunya akan ditetapkan secara default;
      Anda dapat menerima daftar model LLM yang tersedia dengan membuat permintaan terpisah ke endpoint berikut: https://api.dataforseo.com/v3/ai_optimization/perplexity/llm_responses/models

    • system_message
      Tipe: string | null

      instruksi untuk perilaku AI
      field opsional
      menentukan peran, nada, atau perilaku spesifik AI
      Anda dapat menentukan hingga 500 karakter di field system_message

    • tag
      Tipe: string | null

      pengenal tugas yang ditentukan pengguna
      field opsional
      batas karakter adalah 255
      Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
      Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

    • temperature
      Tipe: number | null

      keacakan respons AI
      field opsional
      nilai yang lebih tinggi membuat keluaran lebih beragam
      nilai yang lebih rendah membuat keluaran lebih terfokus
      nilai minimum: 0
      nilai maksimum: 1.9
      nilai default: 0.77

    • top_p
      Tipe: number | null

      keragaman respons AI
      field opsional
      mengontrol keragaman respons dengan membatasi pemilihan token
      nilai minimum: 0
      nilai maksimum: 1
      nilai default: 0.9

    • user_prompt
      Tipe: string

      prompt untuk model AI
      field wajib
      pertanyaan atau tugas yang ingin Anda kirim ke model AI;
      Anda dapat menentukan hingga 500 karakter di field user_prompt

    • web_search_country_iso_code
      Tipe: string | null

      kode negara untuk lokalisasi penelusuran web
      field opsional
      tentukan kode ISO negara untuk mendapatkan hasil penelusuran web yang terlokalisasi
      Catatan: hanya tersedia untuk model Perplexity Sonar
      contoh: US

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveResponseInfo
    • cost
      Tipe: number | null Format: double

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

      pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

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

      array tugas

      • Tipe: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveTaskInfo
        • cost
          Tipe: number | null Format: double

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

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

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

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

          Jalur URL

        • result
          Tipe: array (object | null)[] | null

          array hasil

          • datetime
            Tipe: string | null

            tanggal dan waktu saat hasil diterima
            dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            misalnya:
            2019-11-15 12:57:46 +00:00

          • fan_out_queries
            Tipe: object | null

            array kueri fan-out
            berisi kueri penelusuran terkait yang diturunkan dari kueri utama untuk memberikan respons yang lebih menyeluruh

          • input_tokens
            Tipe: integer | null

            jumlah token pada input
            total token yang diproses

          • items
            Tipe: array (object | null)[] | null

            array item respons
            berisi data respons AI terstruktur

            • Tipe: object | null · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
                • Tipe: object · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
                  • type
                    Diskriminator
                    Tipe: string | null

                    jenis elemen

                  • sections
                    Tipe: array (object | null)[] | null

                    bagian rantai penalaran
                    array objek yang berisi bagian rantai penalaran yang dihasilkan oleh LLM

                    • annotations
                      Tipe: array (object | null)[] | null

                      array referensi yang digunakan untuk menghasilkan respons
                      sama dengan null jika parameter web_search tidak disetel ke true
                      Catatan: annotations dapat mengembalikan kosong meskipun web_search bernilai true, karena AI akan mencoba mengambil informasi web tetapi mungkin tidak menemukan hasil yang relevan

                      • direct_url
                        Tipe: string | null

                        URL langsung ke sumber yang dikutip
                        berisi URL sumber asli yang menjadi tujuan pengalihan Vertex AI di field url

                      • end_index
                        Tipe: integer | null

                        akhir pengindeksan anotasi

                      • start_index
                        Tipe: integer | null

                        awal pengindeksan anotasi

                      • text
                        Tipe: string | null

                        teks bagian rantai penalaran
                        teks bagian rantai penalaran yang merangkum proses pemikiran model

                      • title
                        Tipe: string | null

                        nama domain atau judul sumber yang dikutip

                      • url
                        Tipe: string | null

                        URL pengalihan ke sumber yang dikutip
                        berisi pengalihan Vertex AI yang mengarah ke sumber asli

                    • text
                      Tipe: string | null

                      teks bagian rantai penalaran
                      teks bagian rantai penalaran yang merangkum proses pemikiran model

                    • type
                      Tipe: string | null

                      jenis elemen

          • model_name
            Tipe: string | null

            nama model AI yang digunakan

          • money_spent
            Tipe: number | null

            biaya token AI, USD
            harga yang dikenakan oleh penyedia model AI pihak ketiga sesuai Harga mereka

          • output_tokens
            Tipe: integer | null

            jumlah token pada output
            total token yang dihasilkan dalam respons AI

          • reasoning_tokens
            Tipe: integer | null

            Integer numbers.

          • web_search
            Tipe: boolean | null

            menunjukkan apakah penelusuran web digunakan
            Catatan: penelusuran web diaktifkan secara default pada model Perplexity Sonar

        • result_count
          Tipe: integer | null Format: int64

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

        • status_message
          Tipe: string | null

          pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      versi API saat ini

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat menggunakan format penyedia

    application/json
Request Example for post/v1/beta/dataforseo/ai_optimization/perplexity/llm_responses/live
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/perplexity/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,
    "web_search_country_iso_code": "FR",
    "model_name": "sonar",
    "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": "[Max Depth Exceeded]",
              "sections": "[Max Depth Exceeded]"
            }
          ],
          "fan_out_queries": null
        }
      ]
    }
  ]
}

Operasi berhasil

Live Perplexity LLM Responses