v0.2.0-beta

OpenAPI 3.1.0

Konfiguracja zadań LLM Responses Claude

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/task_post

Konfiguracja zadań LLM Responses Claude

Kolejkuje prompt Claude zamiast czekać i zwraca id zadania. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Najpierw sprawdź task_post_supported w get_dataforseo_ai_claude_llm_responses_models, a wynik pobierz przez get_dataforseo_ai_claude_llm_responses_fetch.

Cennik referencyjny

Rozliczanie: zgłoszony koszt odpowiedzi.
Szacunek referencyjny dla żądania: USD 0.701.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej już kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit 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
- pingback_url
  Typ: string | null
  
  adres URL powiadomienia o zakończonym zadaniu
  pole opcjonalne
  po zakończeniu zadania powiadomimy Cię żądaniem GET wysłanym na podany adres URL
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości
  przykład:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Uwaga: znaki specjalne w pingback_url zostaną zakodowane w adresie URL;
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji znajdziesz w Centrum pomocy
- postback_url
  Typ: string | null
  
  adres URL do wysyłania wyników zadania
  pole opcjonalne
  po zakończeniu zadania wyślemy żądanie POST z wynikami skompresowanymi w formacie gzip na podany postback_url
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
  przykład:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Uwaga: znaki specjalne w postback_url zostaną zakodowane w adresie URL;
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji znajdziesz w Centrum pomocy
- 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_AiOptimizationClaudeLlmResponsesTaskPostResponseInfo
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_AiOptimizationClaudeLlmResponsesTaskPostTaskInfo
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: object | null

tablica wyników
w tym przypadku wartością będzie null

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/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/claude/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?"
      }
    ],
    "max_output_tokens": 1024,
    "temperature": 0.3,
    "web_search_country_iso_code": "FR",
    "model_name": "claude-sonnet-4-0",
    "web_search": true,
    "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": null
    }
  ]
}

Operacja zakończona powodzeniem

Konfiguracja zadań LLM Responses Claude

UwierzytelnianieRequired

DataForSEO

Konfiguracja zadań LLM Responses Claude

Cennik referencyjny