v0.2.0-beta

OpenAPI 3.1.0

Aufgaben für „LLM Responses ChatGPT“ einstellen

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operationen

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

Aufgaben für „LLM Responses ChatGPT“ einstellen

Stellt einen ChatGPT-Prompt in die Warteschlange, statt auf die Antwort zu warten, und gibt eine Aufgaben-id zurück. Ergänzt gegenüber dem Live-Endpunkt system_message und message_chain, sodass eine mehrstufige Unterhaltung in einer Aufgabe gesendet werden kann. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück. ⚠️ Nicht jedes Modell unterstützt die Warteschlange – prüfen Sie task_post_supported in get_dataforseo_ai_chat_gpt_llm_responses_models. Rufen Sie das Ergebnis mit get_dataforseo_ai_chat_gpt_llm_responses_fetch ab.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.701.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen abgerechneten Kundenbetrag anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body

application/json

Typ: array (object | null)[]
- force_web_search
  Typ: boolean | null
  
  KI-Agent zur Websuche zwingen
  Optionales Feld
  Um diesen Parameter zu aktivieren, muss auch web_search aktiviert sein;
  wenn aktiviert, wird das KI-Modell gezwungen, aktuelle Webinformationen abzurufen und zu zitieren;
  Standardwert: false;
  Hinweis: Auch wenn der Parameter auf true gesetzt ist, ist nicht garantiert, dass Webquellen in der Antwort zitiert werden
  Hinweis Nr. 2: wird in Reasoning-Modellen nicht unterstützt
- max_output_tokens
  Typ: integer | null
  
  Maximale Token-Anzahl in der KI-Antwort
  Optionales Feld
  Mindestwert für Reasoning-Modelle (z. B. reasoning ist true im Models-Endpunkt): 1024;
  Mindestwert für Nicht-Reasoning-Modelle: 16;
  Höchstwert: 4096;
  Standardwert: 2048
- message_chain
  Typ: array (object | null)[] | null
  
  Konversationsverlauf Optionales Feld Array aus Nachrichtenobjekten, die frühere Konversationsrunden darstellen; jedes Objekt muss enthalten: role-String mit der Rolle user oder ai; message-String mit dem Nachrichteninhalt (max. 500 Zeichen); im Array können maximal 10 Nachrichtenobjekte angegeben werden; Hinweis: Bei Perplexity-Modellen müssen sich Nachrichten strikt zwischen user- und AI-Rollen abwechseln (user → ai); Beispiel: "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
  
  Nachrichtentext
  
  role
  Typ: string | null
  
  Rolle des Benutzers, von dem die Nachricht stammt
- model_name
  Typ: string
  
  Name des KI-Modells
  Pflichtfeld
  model_namebesteht aus dem tatsächlichen Modellnamen und dem Versionsnamen;
  wird nur der Basisname des Modells angegeben, wird standardmäßig dessen neueste Version gesetzt;
  wird beispielsweise gpt-4.1 angegeben, wird automatisch gpt-4.1-2025-04-14 als model_name gesetzt;
  Die Liste der verfügbaren LLM-Modelle erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models
- pingback_url
  Typ: string | null
  
  Benachrichtigungs-URL für eine abgeschlossene Aufgabe
  Optionales Feld
  Wenn eine Aufgabe abgeschlossen ist, benachrichtigen wir Sie per GET-Anfrage an die von Ihnen angegebene URL
  Sie können die Zeichenfolge ‘$id’ als $id-Variable und ‘$tag’ als URL-kodierte $tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage
  Beispiel:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Hinweis: Sonderzeichen in pingback_url werden URL-kodiert;
  d. h. das Zeichen # wird zu %23 kodiert
  
  Weitere Informationen finden Sie in unserem Help Center
- postback_url
  Typ: string | null
  
  URL zum Senden von Aufgabenergebnissen
  Optionales Feld
  Sobald die Aufgabe abgeschlossen ist, senden wir eine POST-Anfrage mit den im gzip-Format komprimierten Ergebnissen an die von Ihnen angegebene postback_url
  Sie können die Zeichenfolge ‘$id’ als $id-Variable und ‘$tag’ als URL-kodierte $tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage.
  Beispiel:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Hinweis: Sonderzeichen in postback_url werden URL-kodiert;
  d. h. das Zeichen # wird zu %23 kodiert
  
  Weitere Informationen finden Sie in unserem Help Center
- system_message
  Typ: string | null
  
  Anweisungen für das Verhalten der KI
  Optionales Feld
  definiert Rolle, Tonfall oder spezifisches Verhalten der KI;
  Sie können bis zu 500 Zeichen im Feld system_message angeben
- tag
  Typ: string | null
  
  Benutzerdefinierte Aufgaben-ID
  Optionales Feld
  Zeichenlimit: 255
  Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen
  Den angegebenen Wert tag finden Sie im data-Array der Antwort
- temperature
  Typ: number | null
  
  Zufälligkeit der KI-Antwort
  Optionales Feld
  höhere Werte machen die Ausgabe vielfältiger;
  niedrigere Werte machen die Ausgabe fokussierter;
  Mindestwert: 0
  Höchstwert: 2
  Standardwert: 0.94
  Hinweis: wird in Reasoning-Modellen nicht unterstützt
- top_p
  Typ: number | null
  
  Vielfalt der KI-Antwort
  Optionales Feld
  steuert die Vielfalt der Antwort durch Begrenzung der Token-Auswahl;
  Mindestwert: 0
  Höchstwert: 1
  Standardwert: 0.92
  
  Hinweis: top_p kann nicht zusammen mit temperature in derselben Anfrage verwendet werden
- user_prompt
  Typ: string
  
  Prompt für das KI-Modell
  Pflichtfeld
  die Frage oder Aufgabe, die Sie an das KI-Modell senden möchten;
  Sie können bis zu 500 Zeichen im Feld user_prompt angeben
- web_search
  Typ: boolean | null
  
  Websuche aktivieren
  Optionales Feld
  wenn aktiviert, kann das KI-Modell auf aktuelle Webinformationen zugreifen und sie zitieren;
  Standardwert: false;
  Hinweis: Im Models-Endpunkt finden Sie eine Liste der Modelle, die web_search unterstützen;
- web_search_city
  Typ: string | null
  
  Stadtname des Standorts
  Optionales Feld
  Hinweis: wird in den Modellen o3-mini, o1-pro und o1 nicht unterstützt
- web_search_country_iso_code
  Typ: string | null
  
  ISO-Ländercode des Standorts
  Optionales Feld
  Um diesen Parameter zu aktivieren, muss auch web_search aktiviert sein;
  wenn aktiviert, sucht das KI-Modell aus dem von Ihnen angegebenen Land im Web;
  Hinweis: wird in den Modellen o3-mini, o1-pro und o1 nicht unterstützt

Antworten

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

Gesamtkosten der Aufgaben in USD

status_code
Typ: integer | null

allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

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

Array von Aufgaben

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

Gesamtkosten der Aufgaben in USD

data
Typ: object | null

Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben

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

Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format

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

URL-Pfad

result
Typ: object | null

Array von Ergebnissen
in diesem Fall ist der Wert null

result_count
Typ: integer | null Format: int64

Anzahl der Elemente im Ergebnis-Array

status_code
Typ: integer | null

Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

time
Typ: string | null

Ausführungszeit in Sekunden

tasks_count
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array

tasks_error
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden

time
Typ: string | null

Gesamtausführungszeit, Sekunden

version
Typ: string | null

Die aktuelle Version der API
application/json
400

Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
401

Ein gültiger Felo-API-Schlüssel ist erforderlich.
402

Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
403

Das Konto ist für diesen Vorgang nicht berechtigt.
429

Ein Anfrage- oder Ausgabenlimit wurde erreicht.
502

Der Dienst konnte die Anfrage nicht abschließen.
503

Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
504

Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
default

Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

application/json

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

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

Schema anzeigen

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

Erfolgreicher Vorgang

Aufgaben für „LLM Responses ChatGPT“ einstellen

AuthentifizierungRequired

DataForSEO

Aufgaben für „LLM Responses ChatGPT“ einstellen

Preisreferenz