v0.2.0-beta

OpenAPI 3.1.0

Membuat tugas ‘LLM Responses Gemini’

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

post/v1/beta/dataforseo/ai_optimization/gemini/llm_responses/task_post

Membuat tugas ‘LLM Responses Gemini’

Mengantrekan prompt Gemini alih-alih menunggu, mengembalikan id tugas. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Periksa task_post_supported di get_dataforseo_ai_gemini_llm_responses_models, lalu ambil dengan get_dataforseo_ai_gemini_llm_responses_fetch.

Referensi harga

Pengukuran: biaya respons yang dilaporkan.
Perkiraan permintaan referensi: USD 0,701.
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 token maksimum dalam respons AI
  field opsional
  nilai minimum: 1;
  nilai maksimum: 4096;
  nilai default: 2048;
  Catatan: jika web_search disetel ke true atau model reasoning ditentukan dalam permintaan, jumlah token keluaran dapat melebihi batas max_output_tokens yang ditentukan
  Catatan #2: jika use_reasoning disetel ke true, nilai minimum untuk max_output_tokens adalah 1024
- 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 disetel secara default;
  misalnya, jika gemini-1.5-pro ditentukan, gemini-1.5-pro-002 akan otomatis disetel sebagai model_name;
  Anda dapat memperoleh daftar model LLM yang tersedia dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/ai_optimization/gemini/llm_responses/models
- pingback_url
  Tipe: string | null
  
  URL notifikasi tugas yang selesai
  field opsional
  saat tugas selesai, kami akan memberi tahu Anda melalui permintaan GET yang dikirim ke URL yang Anda tentukan
  Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag berenkode URL. Kami akan menyetel nilai yang diperlukan sebelum mengirim permintaan
  contoh:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Catatan: karakter khusus dalam pingback_url akan dienkode URL;
  yaitu, karakter # akan dienkode menjadi %23
  
  pelajari lebih lanjut di Pusat Bantuan kami
- postback_url
  Tipe: string | null
  
  URL untuk mengirim hasil tugas
  field opsional
  setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan
  Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag berenkode URL. Kami akan menyetel nilai yang diperlukan sebelum mengirim permintaan.
  contoh:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Catatan: karakter khusus dalam postback_url akan dienkode URL;
  yaitu, karakter # akan dienkode menjadi %23
  
  pelajari lebih lanjut di Pusat Bantuan kami
- 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: 2
  nilai default: 1.3
- 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
- use_reasoning
  Tipe: boolean | null
  
  aktifkan reasoning untuk model AI
  field opsional
  jika diaktifkan, model akan melakukan reasoning sebelum menghasilkan respons
  lihat endpoint Models untuk daftar model yang mendukung reasoning
  nilai default: false
  Catatan: jika disetel ke true, nilai minimum untuk max_output_tokens adalah 1024
  Catatan #2: untuk model Gemini Pro, use_reasoning akan otomatis disetel ke true
- 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
  Tipe: boolean | null
  
  aktifkan pencarian web untuk informasi terkini
  field opsional
  jika diaktifkan, model AI dapat mengakses dan mengutip informasi web terkini;
  Catatan: lihat endpoint Models untuk daftar model yang mendukung web_search;
  nilai default: false;
  Biaya parameter dapat dihitung di halaman Harga

Respons

200
Tipe: object | null · Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostResponseInfo
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_AiOptimizationGeminiLlmResponsesTaskPostTaskInfo
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: object | null

array hasil
dalam kasus ini, nilainya akan menjadi null

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

post/v1/beta/dataforseo/ai_optimization/gemini/llm_responses/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/gemini/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": "gemini-2.5-flash",
    "user_prompt": "provide information on how relevant the amusement park business is in France now"
  }
]'

Tampilkan Skema

{
  "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 berhasil

Membuat tugas ‘LLM Responses Gemini’

AutentikasiRequired

DataForSEO

Membuat tugas ‘LLM Responses Gemini’

Referensi harga