v0.2.0-beta

OpenAPI 3.1.0

Odpowiedzi LLM Claude na żywo

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

DataForSEO

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

DataForSEO Operacje

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

Odpowiedzi LLM Claude na żywo

Synchronicznie wysyła user_prompt do modelu Claude i zwraca jego odpowiedź. model_name musi pochodzić z get_dataforseo_ai_claude_llm_responses_models — nazwy wyglądają jak claude-sonnet-5, a wiarygodnie wyglądające zgadywanie jest odrzucane. Zwraca model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items i fan_out_queries. Odczytaj money_spent w odpowiedzi, aby zobaczyć, ile faktycznie kosztował prompt. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200.

Informacje referencyjne o rozliczaniu

Rozliczanie: koszt odpowiedzi raportowany przez dostawcę.
Referencyjny szacunek żądania: USD 0.0567.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne — nie stanowią oferty dla konta, gwarantowanej ceny ani limitu wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść

application/json

Typ: array (object | null)[]
- force_web_search
  Typ: boolean | null
  
  wymuś korzystanie z wyszukiwania w sieci przez agenta AI
  pole opcjonalne
  aby włączyć ten parametr, musi być również włączone web_search;
  po włączeniu model AI jest zmuszony do korzystania z bieżących informacji z sieci i cytowania ich;
  wartość domyślna: false;
  Uwaga: nawet jeśli parametr ma wartość true, nie ma gwarancji, że źródła internetowe zostaną zacytowane w odpowiedzi
- max_output_tokens
  Typ: integer | null
  
  maksymalna liczba tokenów w odpowiedzi AI
  pole opcjonalne
  wartość minimalna: 1;
  wartość maksymalna: 4096;
  wartość domyślna: 2048;
  Uwaga: jeśli web_search ma wartość true lub w żądaniu określono model rozumujący, liczba tokenów wyjściowych może przekroczyć limit max_output_tokens
  Uwaga 2: jeśli use_reasoning ma wartość true, wartość minimalna dla max_output_tokens wynosi 1025
- message_chain
  Typ: array (object | null)[] | null
  
  historia konwersacji pole opcjonalne tablica obiektów wiadomości reprezentujących poprzednie tury konwersacji; każdy obiekt musi zawierać: ciąg role o wartości user lub ai; ciąg message z treścią wiadomości (maks. 500 znaków); w tablicy można podać maksymalnie 10 obiektów wiadomości; Uwaga: w modelach Perplexity wiadomości muszą ściśle występować naprzemiennie w rolach user i AI (user → ai); przykład: "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
  
  treść wiadomości
  
  role
  Typ: string | null
  
  rola użytkownika, od którego pochodzi wiadomość
- model_name
  Typ: string
  
  nazwa modelu AI
  pole wymagane
  model_nameskłada się z rzeczywistej nazwy modelu i nazwy wersji;
  jeśli podano podstawową nazwę modelu, domyślnie zostanie ustawiona jej najnowsza wersja;
  na przykład po podaniu claude-opus-4-0 jako model_name zostanie automatycznie ustawiony claude-opus-4-20250514;
  listę dostępnych modeli LLM można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models
- system_message
  Typ: string | null
  
  instrukcje dotyczące zachowania AI
  pole opcjonalne
  określa rolę, ton lub konkretne zachowanie AI;
  w polu system_message można podać do 500 znaków
- tag
  Typ: string | null
  
  identyfikator zadania zdefiniowany przez użytkownika
  pole opcjonalne
  limit znaków: 255
  ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
  podaną wartość tag znajdziesz w obiekcie data odpowiedzi
- temperature
  Typ: number | null
  
  losowość odpowiedzi AI
  pole opcjonalne
  wyższe wartości zwiększają różnorodność odpowiedzi;
  niższe wartości zwiększają skupienie odpowiedzi;
  wartość minimalna: 0
  wartość maksymalna: 1
  wartość domyślna: 0.7
  
  Uwaga: temperature nie może być używane razem z top_p w tym samym żądaniu
- top_p
  Typ: number | null
  
  różnorodność odpowiedzi AI
  pole opcjonalne
  kontroluje różnorodność odpowiedzi przez ograniczanie wyboru tokenów;
  wartość minimalna: 0
  wartość maksymalna: 1
  wartość domyślna: null
  
  Uwaga: top_p nie może być używane razem z temperature w tym samym żądaniu
- use_reasoning
  Typ: boolean | null
  
  włącz rozumowanie dla modelu AI
  pole opcjonalne
  po włączeniu model będzie prowadzić rozumowanie przed wygenerowaniem odpowiedzi
  listę modeli obsługujących reasoning znajdziesz w endpoincie Models
  wartość domyślna: false
  Uwaga: jeśli ustawiono true, wartość minimalna dla max_output_tokens wynosi 1025
  Uwaga 2: jeśli ustawiono true, force_web_search musi mieć wartość false
  Uwaga 3: jeśli ustawiono true, nie można używać temperature ani top_p
- user_prompt
  Typ: string
  
  prompt dla modelu AI
  pole wymagane
  pytanie lub zadanie, które chcesz wysłać do modelu AI;
  w polu user_prompt można podać do 500 znaków
- web_search
  Typ: boolean | null
  
  włącz wyszukiwanie w sieci dla bieżących informacji
  pole opcjonalne
  po włączeniu model AI może uzyskiwać dostęp do bieżących informacji z sieci i je cytować;
  Uwaga: listę modeli obsługujących web_search znajdziesz w endpoincie Models;
  wartość domyślna: false;
  Koszt parametru można obliczyć na stronie Cennik
- web_search_city
  Typ: string | null
  
  nazwa miasta lokalizacji używanej do wyszukiwania w sieci
  pole opcjonalne
- web_search_country_iso_code
  Typ: string | null
  
  kod kraju ISO lokalizacji używanej do wyszukiwania w sieci
  pole opcjonalne
  możliwe wartości: 'AR','AT','AU','BE','BR','CA','CH','CL','CN','DE','DK','ES','FI','FR','GB','HK','ID','IN','IT','JP','KR','MX','MY','NL','NO','NZ','PH','PL','PT','RU','SA','SE','TR','TW','US','ZA'

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResponseInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

status_code
Typ: integer | null

ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

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

tablica zadań

Typ: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveTaskInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

data
Typ: object | null

zawiera te same parametry, które podano w żądaniu POST

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

identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

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

ścieżka URL

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

tablica wyników

datetime
Typ: string | null

data i godzina otrzymania wyniku
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2019-11-15 12:57:46 +00:00

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

tablica zapytań fan-out
zawiera powiązane zapytania wyszukiwania wyprowadzone z głównego zapytania, aby zapewnić bardziej kompleksową odpowiedź

input_tokens
Typ: integer | null

liczba tokenów na wejściu
łączna liczba przetworzonych tokenów

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

tablica elementów odpowiedzi
zawiera ustrukturyzowane dane odpowiedzi AI

type
Typ: string | null

typ elementu

model_name
Typ: string | null

nazwa użytego modelu AI

money_spent
Typ: number | null

koszt tokenów AI, USD
cena pobierana przez zewnętrznego dostawcę modelu AI zgodnie z jego cennikiem

output_tokens
Typ: integer | null

liczba tokenów na wyjściu
łączna liczba tokenów wygenerowanych w odpowiedzi AI

reasoning_tokens
Typ: integer | null

liczba tokenów rozumowania
łączna liczba tokenów użytych do wygenerowania treści rozumowania

web_search
Typ: boolean | null

wskazuje, czy użyto wyszukiwania w sieci

result_count
Typ: integer | null Format: int64

liczba elementów w tablicy result

status_code
Typ: integer | null

kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

time
Typ: string | null

czas wykonania, sekundy

tasks_count
Typ: integer | null Format: int64

liczba zadań w tablicy tasks

tasks_error
Typ: integer | null Format: int64

liczba zadań w tablicy tasks zwróconych z błędem

time
Typ: string | null

łączny czas wykonania, sekundy

version
Typ: string | null

bieżąca wersja interfejsu API
application/json
400

Nie można przetworzyć żądania. Sprawdź parametry żądania.
401

Wymagany jest prawidłowy klucz API Felo.
402

Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
403

Konto nie ma uprawnień do wykonania tej operacji.
429

Osiągnięto limit żądań lub wydatków.
502

Usługa nie mogła ukończyć żądania.
503

API lub usługa rozliczeniowa jest tymczasowo niedostępna.
504

Upłynął limit czasu usługi podczas przetwarzania żądania.
default

Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

application/json

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

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/claude/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,
    "model_name": "claude-opus-4-0",
    "temperature": 0.3,
    "web_search": true,
    "web_search_country_iso_code": "FR",
    "user_prompt": "provide information on how relevant the amusement park business is in France now"
  }
]'

Pokaż schemat

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

Operacja zakończona powodzeniem

Odpowiedzi LLM Claude na żywo

UwierzytelnianieRequired

DataForSEO

Odpowiedzi LLM Claude na żywo

Informacje referencyjne o rozliczaniu