v0.2.0-beta

OpenAPI 3.1.0

Živé Perplexity LLM Responses

Felo API Support

MIT

Server

https://openapi.felo.ai

Klientské knihovny

Shell Curl

DataForSEO

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

DataForSEO Operace

post/v1/beta/dataforseo/ai_optimization/perplexity/llm_responses/live

Živé Perplexity LLM Responses

Odešle user_prompt modelu Perplexity a synchronně vrátí jeho odpověď. model_name musí pocházet z get_dataforseo_ai_perplexity_llm_responses_models – sonar, sonar-pro a sonar-reasoning-pro. web_search_country_iso_code omezuje vyhledávání, což ostatní tři dodavatelé nenabízejí. Vrací model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items a fan_out_queries. Přečtěte si money_spent v odpovědi, abyste zjistili, kolik prompt skutečně stál. Zabalené v obálce DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code – odmítnutý požadavek stále vrací HTTP 200.

Cenová reference

Účtování: nahlášené náklady na odpověď.
Referenční odhad požadavku: USD 0.0163.
Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo

application/json

Typ: array (object | null)[]
- max_output_tokens
  Typ: integer | null
  
  maximální počet tokenů v odpovědi AI
  volitelné pole
  minimální hodnota: 1
  maximální hodnota: 4096;
  výchozí hodnota: 2048;
  Poznámka: pokud je v požadavku zadán uvažující model, počet výstupních tokenů může překročit zadaný limit max_output_tokens
- message_chain
  Typ: array (object | null)[] | null
  
  historie konverzace volitelné pole pole objektů zpráv představujících předchozí tahy konverzace; každý objekt musí obsahovat: řetězec role s hodnotou user nebo ai; řetězec message s obsahem zprávy (max. 500 znaků); v poli můžete zadat maximálně 10 objektů zpráv; Poznámka: u modelů Perplexity se zprávy musí striktně střídat v rolích user a AI (user → ai); příklad: "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
  Typ: string | null
  
  text zprávy
  
  role
  Typ: string | null
  
  role uživatele, od kterého zpráva pochází
- model_name
  Typ: string
  
  název modelu AI
  povinné pole
  model_namese skládá ze skutečného názvu modelu a názvu verze;
  pokud je zadán základní název modelu, bude ve výchozím nastavení použita jeho nejnovější verze;
  seznam dostupných modelů LLM můžete získat samostatným požadavkem na následující endpoint: https://api.dataforseo.com/v3/ai_optimization/perplexity/llm_responses/models
- system_message
  Typ: string | null
  
  pokyny pro chování AI
  volitelné pole
  definuje roli, tón nebo konkrétní chování AI
  v poli system_message můžete zadat až 500 znaků
- tag
  Typ: string | null
  
  uživatelem definovaný identifikátor úlohy
  volitelné pole
  limit znaků je 255
  tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
  zadanou hodnotu tag najdete v objektu data odpovědi
- temperature
  Typ: number | null
  
  náhodnost odpovědi AI
  volitelné pole
  vyšší hodnoty dělají výstup rozmanitější
  nižší hodnoty dělají výstup soustředější
  minimální hodnota: 0
  maximální hodnota: 1.9
  výchozí hodnota: 0.77
- top_p
  Typ: number | null
  
  rozmanitost odpovědi AI
  volitelné pole
  řídí rozmanitost odpovědi omezením výběru tokenů
  minimální hodnota: 0
  maximální hodnota: 1
  výchozí hodnota: 0.9
- user_prompt
  Typ: string
  
  prompt pro model AI
  povinné pole
  otázka nebo úkol, který chcete modelu AI odeslat;
  v poli user_prompt můžete zadat až 500 znaků
- web_search_country_iso_code
  Typ: string | null
  
  kód země pro lokalizaci webového vyhledávání
  volitelné pole
  zadejte kód země ISO pro získání lokalizovaných výsledků webového vyhledávání
  Poznámka: dostupné pouze pro modely Perplexity Sonar
  příklad: US

Odpovědi

200
Typ: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveResponseInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

status_code
Typ: integer | null

obecný kód stavu úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde

tasks
Typ: array (object | null)[] | null

pole úloh

Typ: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveTaskInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

data
Typ: object | null

obsahuje stejné parametry, které jste zadali v požadavku POST

propertyName
Typ: object | null
id
Typ: string | null

identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID

path
Typ: array (string | null)[] | null

cesta URL

result
Typ: array (object | null)[] | null

pole výsledků

datetime
Typ: string | null

datum a čas přijetí výsledku
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:
2019-11-15 12:57:46 +00:00

fan_out_queries
Typ: object | null

pole dotazů fan-out
obsahuje související vyhledávací dotazy odvozené z hlavního dotazu pro komplexnější odpověď

input_tokens
Typ: integer | null

počet tokenů na vstupu
celkový počet zpracovaných tokenů

items
Typ: array (object | null)[] | null

pole položek odpovědi
obsahuje strukturovaná data odpovědi AI

Typ: object | null · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
Typ: object · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
type
Diskriminátor
Typ: string | null

typ prvku

sections
Typ: array (object | null)[] | null

sekce řetězce uvažování
pole objektů obsahujících sekce řetězce uvažování vygenerované LLM

annotations
Typ: array (object | null)[] | null

pole referencí použitých ke generování odpovědi
rovná se null, pokud parametr web_search není nastaven na true
Poznámka: annotations může vrátit prázdnou hodnotu, i když je web_search nastaven na true, protože AI se pokusí získat informace z webu, ale nemusí najít relevantní výsledky

direct_url
Typ: string | null

přímý URL na citovaný zdroj
obsahuje původní URL zdroje, na který vede přesměrování Vertex AI v poli url

end_index
Typ: integer | null

konec indexování anotace

start_index
Typ: integer | null

začátek indexování anotace

text
Typ: string | null

text sekce řetězce uvažování
text sekce řetězce uvažování shrnující myšlenkový postup modelu

title
Typ: string | null

název domény nebo titulek citovaného zdroje

url
Typ: string | null

URL přesměrování na citovaný zdroj
obsahuje přesměrování Vertex AI, které vede k původnímu zdroji

text
Typ: string | null

text sekce řetězce uvažování
text sekce řetězce uvažování shrnující myšlenkový postup modelu

type
Typ: string | null

typ prvku

model_name
Typ: string | null

název použitého modelu AI

money_spent
Typ: number | null

náklady na tokeny AI, USD
cena účtovaná poskytovatelem modelu AI třetí strany podle jeho ceníku

output_tokens
Typ: integer | null

počet tokenů na výstupu
celkový počet tokenů vygenerovaných v odpovědi AI

reasoning_tokens
Typ: integer | null

Integer numbers.

web_search
Typ: boolean | null

označuje, zda bylo použito webové vyhledávání
Poznámka: webové vyhledávání je ve modelech Perplexity Sonar ve výchozím nastavení zapnuto

result_count
Typ: integer | null Formát: int64

počet prvků v poli result

status_code
Typ: integer | null

stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde

time
Typ: string | null

doba provedení, sekundy

tasks_count
Typ: integer | null Formát: int64

počet úloh v poli tasks

tasks_error
Typ: integer | null Formát: int64

počet úloh v poli tasks vrácených s chybou

time
Typ: string | null

celková doba provádění, sekundy

version
Typ: string | null

aktuální verze API
application/json
400

Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
401

Je vyžadován platný API klíč Felo.
402

V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
403

Účet nemá oprávnění tuto operaci provést.
429

Byl dosažen limit požadavků nebo útraty.
502

Služba nemohla požadavek dokončit.
503

API nebo fakturační služba je dočasně nedostupná.
504

Při zpracování požadavku vypršel časový limit služby.
default

Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

application/json

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

Zobrazit schéma

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

Úspěšná operace

Živé Perplexity LLM Responses

OvěřováníRequired

DataForSEO

Živé Perplexity LLM Responses

Cenová reference