v0.2.0-beta

OpenAPI 3.1.0

Nastavení úloh LLM Responses Claude

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

Nastavení úloh LLM Responses Claude

Zařadí prompt Claude do fronty místo čekání a vrátí id úlohy. 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. Nejprve zkontrolujte task_post_supported v get_dataforseo_ai_claude_llm_responses_models a výsledek načtěte pomocí get_dataforseo_ai_claude_llm_responses_fetch.

Cenová reference

Účtování: nahlášené náklady na odpověď.
Referenční odhad požadavku: USD 0.701.
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)[]
- force_web_search
  Typ: boolean | null
  
  vynutit u AI agenta použití webového vyhledávání
  volitelné pole
  pro zapnutí tohoto parametru musí být zapnuto také web_search;
  po zapnutí je model AI nucen přistupovat k aktuálním webovým informacím a citovat je;
  výchozí hodnota: false;
  Poznámka: i když je parametr nastaven na true, není zaručeno, že webové zdroje budou v odpovědi citovány
- 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 web_search nastaveno na true nebo je v požadavku určen model s uvažováním, může počet výstupních tokenů překročit zadaný limit max_output_tokens
  Poznámka 2: pokud je use_reasoning nastaveno na true, minimální hodnota pro max_output_tokens je 1025
- 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, ve výchozím nastavení se nastaví jeho nejnovější verze;
  například pokud je zadáno claude-opus-4-0, automaticky se jako model_name nastaví claude-opus-4-20250514;
  seznam dostupných modelů LLM získáte samostatným požadavkem na https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models
- pingback_url
  Typ: string | null
  
  URL oznámení o dokončené úloze
  volitelné pole
  po dokončení úlohy vás upozorníme požadavkem GET odeslaným na zadanou URL
  řetězec ‘$id’ můžete použít jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty
  příklad:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Poznámka: speciální znaky v pingback_url budou kódovány v URL;
  mj. znak # bude zakódován jako %23
  
  další informace najdete v Centru nápovědy
- postback_url
  Typ: string | null
  
  URL pro odesílání výsledků úlohy
  volitelné pole
  po dokončení úlohy odešleme požadavek POST s výsledky komprimovanými ve formátu gzip na zadanou postback_url
  řetězec ‘$id’ můžete použít jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
  příklad:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Poznámka: speciální znaky v postback_url budou kódovány v URL;
  mj. znak # bude zakódován jako %23
  
  další informace najdete v Centru nápovědy
- 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 zvyšují rozmanitost výstupu;
  nižší hodnoty zvyšují zaměření výstupu;
  minimální hodnota: 0
  maximální hodnota: 1
  výchozí hodnota: 0.7
  
  Poznámka: temperature nelze v jednom požadavku použít společně s top_p
- 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: null
  
  Poznámka: top_p nelze v jednom požadavku použít společně s temperature
- use_reasoning
  Typ: boolean | null
  
  zapnout uvažování pro model AI
  volitelné pole
  po zapnutí bude model před generováním odpovědi provádět uvažování
  seznam modelů, které podporují reasoning, najdete v endpointu Models
  výchozí hodnota: false
  Poznámka: pokud je nastaveno na true, minimální hodnota pro max_output_tokens je 1025
  Poznámka 2: pokud je nastaveno na true, force_web_search musí být nastaveno na false
  Poznámka 3: pokud je nastaveno na true, nelze použít temperature ani top_p
- 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
  Typ: boolean | null
  
  zapnout webové vyhledávání aktuálních informací
  volitelné pole
  po zapnutí může model AI přistupovat k aktuálním webovým informacím a citovat je;
  Poznámka: seznam modelů, které podporují web_search, najdete v endpointu Models;
  výchozí hodnota: false;
  Cenu tohoto parametru lze vypočítat na stránce Ceny
- web_search_city
  Typ: string | null
  
  název města lokality používané k vyhledávání na webu
  volitelné pole
- web_search_country_iso_code
  Typ: string | null
  
  kód země ISO lokality používané k vyhledávání na webu
  volitelné pole
  možné hodnoty: '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'

Odpovědi

200
Typ: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesTaskPostResponseInfo
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_AiOptimizationClaudeLlmResponsesTaskPostTaskInfo
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: object | null

pole výsledků
v tomto případě bude hodnota null

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

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": null
    }
  ]
}

Úspěšná operace

Nastavení úloh LLM Responses Claude

OvěřováníRequired

DataForSEO

Nastavení úloh LLM Responses Claude

Cenová reference