> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Doubao Seed 2.0 Responses API - Vollstaendige API-Referenz

> - Doubao Seed 2.0 Modelle im Responses-API-Format aufrufen
- **Serverseitige Kontextspeicherung**: Mehrrunden-Konversation ueber `previous_response_id`, ohne manuelles Senden des Nachrichtenverlaufs
- **Multimodale Eingabe**: Unterstuetzung fuer Text + Bild + Video + Datei (PDF) gemischte Eingabe
- **Tiefes Denken**: Unterstuetzung fuer thinking Chain-of-Thought-Modus
- **Tool Calling**: Unterstuetzung fuer Function Calling, Websuche, Bildverarbeitung, MCP-Tools, Private Wissensdatenbank, Doubao-Assistent
- **Kontext-Caching**: Unterstuetzung fuer caching-Mechanismus zur Kostensenkung
- **Strukturierte Ausgabe**: Unterstuetzung fuer JSON Object / JSON Schema Format
- **Kontextverwaltung**: Unterstuetzung fuer context_management Strategien
- Schnelleinstieg? Siehe [Schnellstart-Dokumentation](./doubao-seed-2.0-responses-quickstart)

<Note>
  **BaseURL**: Die Standard-BaseURL ist `https://direct.evolink.ai` und bietet bessere Unterstützung für Textmodelle sowie persistente Verbindungen. `https://api.evolink.ai` ist der primäre Endpunkt für multimodale Dienste und dient bei Textmodellen als Ausweichadresse.
</Note>


## OpenAPI

````yaml de/api-manual/language-series/doubao-seed-2.0/doubao-seed-2.0-responses-reference.json POST /v1/responses
openapi: 3.1.0
info:
  title: Doubao Seed 2.0 Responses API Vollstaendige API-Referenz
  description: >-
    Vollstaendige Referenz fuer die Doubao Seed 2.0 Responses API,
    einschliesslich aller Parameter und erweiterten Funktionen
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://direct.evolink.ai
    description: Produktion (empfohlen)
  - url: https://api.evolink.ai
    description: Alternative URL
security:
  - bearerAuth: []
tags:
  - name: Responses API
    description: Responses API Chat-Generierungsschnittstelle
paths:
  /v1/responses:
    post:
      tags:
        - Responses API
      summary: Doubao Seed 2.0 Responses API
      description: >-
        - Doubao Seed 2.0 Modelle im Responses-API-Format aufrufen

        - **Serverseitige Kontextspeicherung**: Mehrrunden-Konversation ueber
        `previous_response_id`, ohne manuelles Senden des Nachrichtenverlaufs

        - **Multimodale Eingabe**: Unterstuetzung fuer Text + Bild + Video +
        Datei (PDF) gemischte Eingabe

        - **Tiefes Denken**: Unterstuetzung fuer thinking Chain-of-Thought-Modus

        - **Tool Calling**: Unterstuetzung fuer Function Calling, Websuche,
        Bildverarbeitung, MCP-Tools, Private Wissensdatenbank, Doubao-Assistent

        - **Kontext-Caching**: Unterstuetzung fuer caching-Mechanismus zur
        Kostensenkung

        - **Strukturierte Ausgabe**: Unterstuetzung fuer JSON Object / JSON
        Schema Format

        - **Kontextverwaltung**: Unterstuetzung fuer context_management
        Strategien

        - Schnelleinstieg? Siehe
        [Schnellstart-Dokumentation](./doubao-seed-2.0-responses-quickstart)
      operationId: createResponseDoubaoSeed20
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResponseRequest'
            examples:
              simple_text:
                summary: Reiner Texteingabe
                value:
                  model: doubao-seed-2.0-pro
                  input: Bitte stellen Sie sich vor
              multi_turn:
                summary: Mehrrunden-Konversation (ueber previous_response_id)
                value:
                  model: doubao-seed-2.0-pro
                  input: Was sind die Vorteile?
                  previous_response_id: resp_0217****
              message_array:
                summary: Nachrichtenliste-Eingabe
                value:
                  model: doubao-seed-2.0-pro
                  input:
                    - role: system
                      type: message
                      content: >-
                        Sie sind ein professioneller
                        Python-Programmierassistent.
                    - role: user
                      type: message
                      content: Wie liest man eine Datei?
              thinking_mode:
                summary: Tiefes-Denken-Modus aktivieren
                value:
                  model: doubao-seed-2.0-pro
                  input: Beweisen Sie, dass die Quadratwurzel von 2 irrational ist
                  thinking:
                    type: enabled
              web_search:
                summary: Websuche
                value:
                  model: doubao-seed-2.0-pro
                  input: Wie ist das Wetter heute in Berlin?
                  tools:
                    - type: web_search
      responses:
        '200':
          description: Antwortgenerierung erfolgreich
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseObject'
        '400':
          description: Ungueltige Anfrageparameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 400
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: Nicht authentifiziert, Token ungueltig oder abgelaufen
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 401
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Unzureichendes Kontingent, Aufladung erforderlich
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 402
                  message: Insufficient quota
                  type: insufficient_quota_error
                  fallback_suggestion: https://evolink.ai/dashboard/billing
        '403':
          description: Kein Zugriff erlaubt
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 403
                  message: Access denied for this model
                  type: permission_error
                  param: model
        '404':
          description: Ressource nicht gefunden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 404
                  message: Specified model not found
                  type: not_found_error
                  param: model
                  fallback_suggestion: doubao-seed-2.0-pro
        '413':
          description: Anfrage zu gross
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 413
                  message: Image file too large
                  type: request_too_large_error
                  param: content
                  fallback_suggestion: compress image to under 10MB
        '429':
          description: Anfragelimit ueberschritten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 429
                  message: Rate limit exceeded
                  type: rate_limit_error
                  fallback_suggestion: retry after 60 seconds
        '500':
          description: Interner Serverfehler
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 500
                  message: Internal server error
                  type: internal_server_error
                  fallback_suggestion: try again later
        '502':
          description: Upstream-Dienstfehler
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 502
                  message: Upstream AI service unavailable
                  type: upstream_error
                  fallback_suggestion: try different model
        '503':
          description: Dienst voruebergehend nicht verfuegbar
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 503
                  message: Service temporarily unavailable
                  type: service_unavailable_error
                  fallback_suggestion: retry after 30 seconds
components:
  schemas:
    ResponseRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          description: >-
            Chat-Modellname


            - `doubao-seed-2.0-pro`: Flaggschiff-Version, staerkste
            Gesamtleistung

            - `doubao-seed-2.0-lite`: Leichtversion, schneller, gutes
            Preis-Leistungs-Verhaeltnis

            - `doubao-seed-2.0-mini`: Ultraschnelle Version, schnellste Antwort

            - `doubao-seed-2.0-code`: Code-Spezialversion, optimiert fuer
            Codegenerierung
          enum:
            - doubao-seed-2.0-pro
            - doubao-seed-2.0-lite
            - doubao-seed-2.0-mini
            - doubao-seed-2.0-code
          default: doubao-seed-2.0-pro
        input:
          description: Eingabeinhalt, unterstuetzt reinen Text oder Nachrichtenliste
          oneOf:
            - type: string
              description: Reiner Texteingabe
            - type: array
              description: Nachrichtenliste-Eingabe
              items:
                $ref: '#/components/schemas/InputItem'
        instructions:
          type: string
          nullable: true
          description: |-
            Systemanweisungen, definieren das Verhalten und die Rolle der KI

            Aehnlich wie system-Rolle in der Chat Completions API
        previous_response_id:
          type: string
          nullable: true
          description: |-
            ID der vorherigen Antwort fuer Mehrrunden-Konversation

            Der Server laedt automatisch den Kontext der vorherigen Konversation
        stream:
          type: boolean
          description: Ob Streaming-Ausgabe aktiviert werden soll
          default: false
        thinking:
          type: object
          description: Steuert, ob das Modell den Tiefes-Denken-Modus aktiviert
          properties:
            type:
              type: string
              description: |-
                Denkmodus

                - `enabled`: Denkmodus aktiviert
                - `disabled`: Denkmodus deaktiviert
                - `auto`: Automatischer Denkmodus
              enum:
                - enabled
                - disabled
                - auto
          required:
            - type
        max_output_tokens:
          type: integer
          nullable: true
          description: |-
            Maximale Ausgabe-Token-Anzahl des Modells

            Wertebereich: [1, 65536]
          minimum: 1
          maximum: 65536
        temperature:
          type: number
          nullable: true
          description: |-
            Sampling-Temperatur, steuert die Zufaelligkeit der Ausgabe

            Wertebereich: [0, 2]
          minimum: 0
          maximum: 2
          default: 1
        top_p:
          type: number
          nullable: true
          description: |-
            Nucleus-Sampling-Wahrscheinlichkeitsschwelle

            Wertebereich: [0, 1]
          minimum: 0
          maximum: 1
          default: 0.7
        reasoning_effort:
          type: string
          nullable: true
          description: |-
            Begrenzt den Denkaufwand

            - `minimal`: Denken deaktiviert
            - `low`: Leichtes Denken
            - `medium`: Ausgewogener Modus
            - `high`: Tiefenanalyse
          enum:
            - minimal
            - low
            - medium
            - high
        store:
          type: boolean
          description: |-
            Ob die Antwort serverseitig gespeichert werden soll

            Muss true sein, um previous_response_id zu verwenden
          default: true
        caching:
          type: object
          description: Cache-Konfiguration zur Kostensenkung
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
              default: disabled
        text:
          type: object
          description: Textausgabeformat des Modells festlegen
          properties:
            format:
              type: object
              description: Textausgabeformat festlegen
              properties:
                type:
                  type: string
                  description: |-
                    Formattyp

                    - `text`: Natuerliche Sprache (Standard)
                    - `json_object`: JSON-Objektformat
                    - `json_schema`: JSON-Format gemaess schema-Definition
                  enum:
                    - text
                    - json_object
                    - json_schema
                  default: text
                name:
                  type: string
                  description: JSON-Strukturname (erforderlich wenn type json_schema ist)
                schema:
                  type: object
                  description: >-
                    JSON-Schema-Formatdefinition (erforderlich wenn type
                    json_schema ist)
                description:
                  type: string
                  nullable: true
                  description: Beschreibung des Antwortzwecks
                strict:
                  type: boolean
                  nullable: true
                  description: Ob der strikte Befolgungsmodus aktiviert werden soll
                  default: false
              required:
                - type
        tools:
          type: array
          description: |-
            Liste der vom Modell aufrufbaren Werkzeuge

            Unterstuetzte Werkzeugtypen:
            - `function`: Benutzerdefinierte Funktion (Function Calling)
            - `web_search`: Websuche
            - `doubao_app`: Doubao-Assistent
            - `image_process`: Bildverarbeitung
            - `mcp`: MCP-Tools
            - `knowledge_search`: Private Wissensdatenbanksuche
          items:
            $ref: '#/components/schemas/Tool'
        tool_choice:
          description: |-
            Steuert, ob das Modell Werkzeuge aufruft

            **Zeichenkettenmodus**:
            - `none`: Keine Werkzeuge aufrufen
            - `required`: Werkzeug muss aufgerufen werden
            - `auto`: Modell entscheidet selbst (Standard)

            **Objektmodus**: Bestimmtes Werkzeug zum Aufrufen angeben
          oneOf:
            - type: string
              enum:
                - none
                - auto
                - required
            - $ref: '#/components/schemas/ToolChoiceObject'
        max_tool_calls:
          type: integer
          description: >-
            Maximale Werkzeugaufruf-Runden (unbegrenzte Aufrufe pro Runde)


            - Wertebereich: [1, 10]

            - Web Search Standardwert 3

            - Image Process Standardwert 10 (nicht aenderbar)

            - Knowledge Search Standardwert 3


            **Hinweis**: Dieser Parameter ist Best-Effort, die tatsaechliche
            Aufrufanzahl haengt von der Modell-Inferenz ab
          minimum: 1
          maximum: 10
        context_management:
          type: object
          description: >-
            Kontextverwaltungsstrategie, hilft dem Modell das Kontextfenster
            effektiv zu nutzen
          properties:
            edits:
              type: array
              description: Liste der Kontextbearbeitungsstrategien
              items:
                $ref: '#/components/schemas/ContextEdit'
    ResponseObject:
      type: object
      properties:
        id:
          type: string
          description: Eindeutige Kennung dieser Antwort
          example: resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e
        object:
          type: string
          description: Objekttyp, fester Wert response
          enum:
            - response
          example: response
        created_at:
          type: number
          description: Unix-Zeitstempel der Erstellung (Sekunden)
          example: 1771486674
        model:
          type: string
          description: Tatsaechlich verwendeter Modellname und Version
          example: doubao-seed-2-0-pro-260215
        status:
          type: string
          description: |-
            Antwortstatus

            - `completed`: Generierung abgeschlossen
            - `in_progress`: Generierung laeuft
            - `incomplete`: Unvollstaendig
            - `failed`: Fehlgeschlagen
          enum:
            - completed
            - in_progress
            - incomplete
            - failed
          example: completed
        output:
          type: array
          description: >-
            Modellausgabe-Inhaltsliste, einschliesslich Chain-of-Thought,
            Nachrichtenausgabe, Werkzeugaufruf-Ausgabe usw.
          items:
            $ref: '#/components/schemas/OutputItem'
        service_tier:
          type: string
          description: |-
            Service-Stufe dieser Anfrage

            - `default`: Standard-Service-Stufe
            - `scale`: Garantiepaket-Kontingent verwendet
          example: default
        instructions:
          type: string
          nullable: true
          description: Fuer diese Anfrage verwendete Systemanweisungen
        previous_response_id:
          type: string
          nullable: true
          description: Referenzierte vorherige Antwort-ID
        max_output_tokens:
          type: integer
          description: Maximale Ausgabe-Token-Anzahl des Modells
          example: 32768
        temperature:
          type: number
          nullable: true
          description: Verwendete Sampling-Temperatur
        top_p:
          type: number
          nullable: true
          description: Verwendeter top_p-Wert
        thinking:
          type: object
          nullable: true
          description: Verwendete Denkmodus-Konfiguration
        tools:
          type: array
          nullable: true
          description: Verwendete Werkzeugliste
        tool_choice:
          nullable: true
          description: Verwendete Werkzeugauswahl-Konfiguration
        parallel_tool_calls:
          type: boolean
          nullable: true
          description: Ob parallele Werkzeugaufrufe erlaubt sind
        text:
          type: object
          nullable: true
          description: Textausgabeformat-Konfiguration
        usage:
          $ref: '#/components/schemas/Usage'
        caching:
          type: object
          description: Cache-Konfiguration
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
        store:
          type: boolean
          description: Ob die Antwort gespeichert wurde
        expire_at:
          type: integer
          description: Speicher-Ablaufzeitpunkt (Unix-Zeitstempel)
          example: 1756539922
        error:
          type: object
          nullable: true
          description: Fehlerinformationen, bei Erfolg null
        incomplete_details:
          type: object
          nullable: true
          description: Detaillierter Grund fuer Unvollstaendigkeit
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
              description: HTTP-Status-Fehlercode
            message:
              type: string
              description: Fehlerbeschreibung
            type:
              type: string
              description: Fehlertyp
            param:
              type: string
              description: Zugehoeriger Parametername
            fallback_suggestion:
              type: string
              description: Vorschlag bei Fehler
    InputItem:
      type: object
      description: >-
        Eingabeelement, kann Nachricht, Werkzeugaufruf, Werkzeugergebnis oder
        Chain-of-Thought sein
      properties:
        type:
          type: string
          description: |-
            Eingabetyp

            - `message`: Nachrichteneingabe
            - `function_call`: Werkzeugfunktionsaufruf
            - `function_call_output`: Werkzeugergebnis
            - `reasoning`: Chain-of-Thought-Information
          enum:
            - message
            - function_call
            - function_call_output
            - reasoning
        role:
          type: string
          description: |-
            Nachrichtenrolle (wenn type message ist)

            - `user`: Benutzernachricht
            - `system`: Systemnachricht
            - `assistant`: Assistentennachricht
            - `developer`: Entwicklernachricht (hoehere Prioritaet als user)
          enum:
            - user
            - system
            - assistant
            - developer
        content:
          description: >-
            Nachrichteninhalt, unterstuetzt reinen Text oder Inhaltsobjekt-Array
            (Text, Bild, Video, Datei)
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/InputContentPart'
        partial:
          type: boolean
          description: >-
            Fortsetzungsmodus (nur assistant-Rolle)


            Setzen Sie partial der letzten assistant-Nachricht auf true, das
            Modell setzt den content-Inhalt fort
        status:
          type: string
          description: Elementstatus
          enum:
            - in_progress
            - completed
            - incomplete
        arguments:
          type: string
          description: >-
            JSON-Zeichenkette der Funktionsparameter (erforderlich wenn type
            function_call ist)
        call_id:
          type: string
          description: >-
            Eindeutige ID des Funktionswerkzeugaufrufs (erforderlich wenn type
            function_call/function_call_output ist)
        name:
          type: string
          description: Funktionsname (erforderlich wenn type function_call ist)
        output:
          type: string
          description: >-
            Werkzeugausgabeergebnis (erforderlich wenn type function_call_output
            ist)
        id:
          type: string
          description: >-
            Eindeutige Kennung der Chain-of-Thought-Information (wenn type
            reasoning ist)
        summary:
          type: array
          description: Chain-of-Thought-Inhalt (wenn type reasoning ist)
          items:
            type: object
            properties:
              text:
                type: string
                description: Chain-of-Thought-Text
              type:
                type: string
                description: Typ, fester Wert summary_text
                enum:
                  - summary_text
    Tool:
      type: object
      description: >-
        Werkzeugdefinition. Verschiedene Werkzeugtypen werden ueber das
        type-Feld ausgewaehlt
      required:
        - type
      properties:
        type:
          type: string
          description: |-
            Werkzeugtyp

            - `function`: Benutzerdefinierte Funktion
            - `web_search`: Websuche
            - `doubao_app`: Doubao-Assistent
            - `image_process`: Bildverarbeitung
            - `mcp`: MCP-Tools
            - `knowledge_search`: Private Wissensdatenbanksuche
          enum:
            - function
            - web_search
            - doubao_app
            - image_process
            - mcp
            - knowledge_search
        name:
          type: string
          description: Funktionsname (erforderlich wenn type function ist)
        description:
          type: string
          description: Funktionsbeschreibung / Wissensdatenbankbeschreibung
        parameters:
          type: object
          description: Funktionsparameter, JSON-Schema-Format (wenn type function ist)
        strict:
          type: boolean
          description: >-
            Ob strikte Parametervalidierung erzwungen werden soll (wenn type
            function ist)
          default: true
        feature:
          type: object
          description: Doubao-Assistent Unterfunktionen (wenn type doubao_app ist)
          properties:
            chat:
              type: object
              description: Alltaegliche Kommunikationsfunktion
              properties:
                type:
                  type: string
                  enum:
                    - enabled
                    - disabled
                  default: disabled
                role_description:
                  type: string
                  description: >-
                    Rollenbeschreibung (gegenseitig ausschliessend mit system
                    prompt / instructions)
            deep_chat:
              type: object
              description: Tiefgehende Kommunikationsfunktion
              properties:
                type:
                  type: string
                  enum:
                    - enabled
                    - disabled
                  default: disabled
            ai_search:
              type: object
              description: Websuche-Funktion
              properties:
                type:
                  type: string
                  enum:
                    - enabled
                    - disabled
                  default: disabled
                role_description:
                  type: string
                  description: Rollenbeschreibung
            reasoning_search:
              type: object
              description: Denken-und-Suchen-Funktion
              properties:
                type:
                  type: string
                  enum:
                    - enabled
                    - disabled
                  default: disabled
                role_description:
                  type: string
                  description: Rollenbeschreibung
        user_location:
          type: object
          description: Benutzerstandort (wenn type doubao_app / web_search ist)
          properties:
            type:
              type: string
              description: Standorttyp
              default: approximate
            country:
              type: string
              description: Land
            region:
              type: string
              description: Bundesland/Region
            city:
              type: string
              description: Stadt
        sources:
          type: array
          description: |-
            Zusaetzliche Inhaltsquellen fuer Websuche (wenn type web_search ist)

            - `toutiao`: Toutiao-Artikel
            - `douyin`: Douyin-Enzyklopaedie
            - `moji`: Moji-Wetter
          items:
            type: string
            enum:
              - toutiao
              - douyin
              - moji
        limit:
          type: integer
          description: |-
            Maximale Abrufanzahl

            - web_search: [1, 50], Standard 10
            - knowledge_search: [1, 200], Standard 10
        max_keyword:
          type: integer
          description: >-
            Maximale Anzahl paralleler Suchbegriffe, Wertebereich [1, 50]
            (web_search / knowledge_search)
        point:
          type: object
          description: Punkt-/Linienfunktion (wenn type image_process ist)
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
              default: enabled
        grounding:
          type: object
          description: Auswahl-/Zuschnittfunktion (wenn type image_process ist)
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
              default: enabled
        zoom:
          type: object
          description: Zoomfunktion (wenn type image_process ist)
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
              default: enabled
        rotate:
          type: object
          description: Rotationsfunktion (wenn type image_process ist)
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
              default: enabled
        server_label:
          type: string
          description: MCP-Server-Label (erforderlich wenn type mcp ist)
        server_url:
          type: string
          description: MCP-Server-Zugriffsadresse (erforderlich wenn type mcp ist)
        headers:
          type: object
          description: MCP-Server HTTP-Anfrage-Header (wenn type mcp ist)
          additionalProperties:
            type: string
        require_approval:
          description: >-
            MCP-Werkzeug-Genehmigungseinstellung (wenn type mcp ist)


            **Zeichenkettenmodus**: `always` (alle bestaetigen) / `never` (keine
            Bestaetigung)


            **Objektmodus**: Festlegen welche Werkzeuge Genehmigung benoetigen
          oneOf:
            - type: string
              enum:
                - always
                - never
            - type: object
              properties:
                always:
                  type: object
                  properties:
                    tool_names:
                      type: array
                      items:
                        type: string
                      description: Liste der Werkzeugnamen die Bestaetigung erfordern
                never:
                  type: object
                  properties:
                    tool_names:
                      type: array
                      items:
                        type: string
                      description: Liste der Werkzeugnamen die keine Bestaetigung erfordern
        allowed_tools:
          description: |-
            MCP-Werkzeug-Ladebereich (wenn type mcp ist)

            **Array-Modus**: Liste der erlaubten Werkzeugnamen

            **Objektmodus**: Ueber tool_names festlegen
          oneOf:
            - type: array
              items:
                type: string
            - type: object
              properties:
                tool_names:
                  type: array
                  items:
                    type: string
        knowledge_resource_id:
          type: string
          description: >-
            Private Wissensdatenbank-ID (erforderlich wenn type knowledge_search
            ist)
        doc_filters:
          type: object
          description: Wissensdatenbank-Abruffilter (wenn type knowledge_search ist)
        dense_weight:
          type: number
          description: |-
            Dichte-Vektor-Gewicht (wenn type knowledge_search ist)

            - Wertebereich: [0.2, 1]
            - 1 bedeutet reine Dichte-Suche, gegen 0 bedeutet reine Wortsuche
            - Nur bei Hybrid-Suche (hnsw_hybrid) wirksam
          minimum: 0.2
          maximum: 1
          default: 0.5
        ranking_options:
          type: object
          description: >-
            Wissensdatenbank-Abruf-Nachbearbeitungsoptionen (wenn type
            knowledge_search ist)
          properties:
            rerank_switch:
              type: boolean
              description: Ob automatisches Reranking durchgefuehrt werden soll
              default: false
            retrieve_count:
              type: integer
              description: >-
                Anzahl der Chunks fuer Reranking (wirksam wenn rerank_switch
                true ist)
              default: 25
            get_attachment_link:
              type: boolean
              description: >-
                Ob temporaere Download-Links fuer Bilder in Chunks abgerufen
                werden sollen
              default: false
            chunk_diffusion_count:
              type: integer
              description: >-
                Anzahl der benachbarten Chunks um getroffene Chunks
                zurueckzugeben


                Wertebereich: [0, 5], 0 bedeutet kein Chunk-Diffusion
              minimum: 0
              maximum: 5
              default: 0
            chunk_group:
              type: boolean
              description: >-
                Textaggregation, Chunks nach Dokument und Reihenfolge neu
                aggregieren und sortieren
              default: false
            rerank_model:
              type: string
              description: >-
                Rerank-Modellauswahl


                - `base-multilingual-rerank` (empfohlen): Schnell, Langtext, 70+
                Sprachen

                - `m3-v2-rerank`: Standardtext, 100+ Sprachen
              enum:
                - base-multilingual-rerank
                - m3-v2-rerank
              default: base-multilingual-rerank
            rerank_only_chunk:
              type: boolean
              description: >-
                Ob Rerank-Score nur basierend auf Chunk-Inhalt berechnet werden
                soll


                - `true`: Nur basierend auf Chunk-Inhalt

                - `false`: Basierend auf Chunk-Titel + Inhalt
              default: false
    ToolChoiceObject:
      type: object
      required:
        - type
      description: Bestimmtes Werkzeug zum Aufrufen angeben
      properties:
        type:
          type: string
          description: |-
            Werkzeugtyp

            - `function`: Benutzerdefinierte Funktion, name-Feld erforderlich
            - Andere eingebaute Werkzeugnamen
        name:
          type: string
          description: >-
            Name des aufzurufenden Werkzeugs (erforderlich wenn type function
            ist)
    ContextEdit:
      type: object
      description: Kontextbearbeitungsstrategie
      properties:
        type:
          type: string
          description: |-
            Strategietyp

            - `clear_thinking`: Denkbloecke loeschen
            - `clear_tool_uses`: Werkzeugaufruf-Inhalte loeschen
          enum:
            - clear_thinking
            - clear_tool_uses
        keep:
          description: |-
            Inhaltsbeibehaltungsstrategie

            **Zeichenkettenmodus**: `all` (alle Chain-of-Thought beibehalten)

            **Objektmodus**: Beibehaltungsstrategie festlegen
          oneOf:
            - type: string
              enum:
                - all
            - type: object
              properties:
                type:
                  type: string
                  description: >-
                    Beibehaltungsstrategietyp


                    - `thinking_turns`: Letzte N Runden Chain-of-Thought
                    beibehalten

                    - `tool_uses`: Letzte N Runden Werkzeugaufrufe beibehalten
                  enum:
                    - thinking_turns
                    - tool_uses
                value:
                  type: integer
                  description: Anzahl der beizubehaltenden Runden
                  default: 1
        exclude_tools:
          type: array
          description: >-
            Liste der Werkzeugnamen die nicht geloescht werden (wenn type
            clear_tool_uses ist)
          items:
            type: string
        clear_tool_input:
          type: boolean
          description: >-
            Ob Werkzeugaufruf-Parameter geloescht werden sollen (wenn type
            clear_tool_uses ist)
          default: false
        trigger:
          type: object
          description: >-
            Schwellenwert zum Ausloesen der Loeschstrategie (wenn type
            clear_tool_uses ist)
          properties:
            type:
              type: string
              description: |-
                Ausloesertyp

                - `token_count`: Basierend auf Token-Anzahl ausloesen
              enum:
                - token_count
            threshold:
              type: integer
              description: >-
                Token-Anzahl-Schwellenwert, Loeschung wird ausgeloest wenn
                ueberschritten
    OutputItem:
      oneOf:
        - $ref: '#/components/schemas/ReasoningOutput'
        - $ref: '#/components/schemas/MessageOutput'
        - $ref: '#/components/schemas/FunctionCallOutput'
    Usage:
      type: object
      description: Token-Verbrauchsstatistiken
      properties:
        input_tokens:
          type: integer
          description: Anzahl der Eingabe-Token
          example: 88
        input_tokens_details:
          type: object
          description: Details zu Eingabe-Token
          properties:
            cached_tokens:
              type: integer
              description: Anzahl der gecachten Token
              example: 0
        output_tokens:
          type: integer
          description: Anzahl der Ausgabe-Token
          example: 230
        output_tokens_details:
          type: object
          description: Details zu Ausgabe-Token
          properties:
            reasoning_tokens:
              type: integer
              description: Anzahl der Reasoning/Chain-of-Thought-Token
              example: 211
        total_tokens:
          type: integer
          description: Gesamtanzahl der Token
          example: 318
    InputContentPart:
      oneOf:
        - $ref: '#/components/schemas/InputText'
        - $ref: '#/components/schemas/InputImage'
        - $ref: '#/components/schemas/InputVideo'
        - $ref: '#/components/schemas/InputFile'
    ReasoningOutput:
      title: Chain-of-Thought-Ausgabe
      type: object
      properties:
        id:
          type: string
          description: Ausgabeelement-ID
          example: rs_0217****404a
        type:
          type: string
          description: Ausgabetyp
          enum:
            - reasoning
        summary:
          type: array
          description: Chain-of-Thought-Inhalt
          items:
            type: object
            properties:
              text:
                type: string
                description: Chain-of-Thought-Text
              type:
                type: string
                enum:
                  - summary_text
        status:
          type: string
          enum:
            - in_progress
            - completed
            - incomplete
          example: completed
    MessageOutput:
      title: Nachrichtenausgabe
      type: object
      properties:
        id:
          type: string
          description: Ausgabeelement-ID
          example: msg_0217****a93c
        type:
          type: string
          enum:
            - message
        role:
          type: string
          enum:
            - assistant
        content:
          type: array
          description: Nachrichteninhaltsliste
          items:
            type: object
            properties:
              text:
                type: string
                description: Textinhalt
              type:
                type: string
                description: Inhaltstyp
                enum:
                  - output_text
              annotations:
                type: array
                nullable: true
                description: Anmerkungsinformationen (Websuchquellen usw.)
        status:
          type: string
          enum:
            - in_progress
            - completed
            - incomplete
          example: completed
    FunctionCallOutput:
      title: Werkzeugaufruf-Ausgabe
      type: object
      properties:
        id:
          type: string
          description: Ausgabeelement-ID
        type:
          type: string
          enum:
            - function_call
        call_id:
          type: string
          description: Aufruf-ID
        name:
          type: string
          description: Funktionsname
        arguments:
          type: string
          description: Funktionsparameter JSON-Zeichenkette
        status:
          type: string
          enum:
            - in_progress
            - completed
            - incomplete
    InputText:
      title: Texteingabe
      type: object
      required:
        - type
        - text
      properties:
        type:
          type: string
          enum:
            - input_text
          description: Eingabetyp, fester Wert input_text
        text:
          type: string
          description: Eingabetextinhalt
    InputImage:
      title: Bildeingabe
      type: object
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - input_image
          description: Eingabetyp, fester Wert input_image
        image_url:
          type: string
          description: Bild-URL oder Base64-kodierte Data-URL
        file_id:
          type: string
          description: Ueber Files API hochgeladene Datei-ID
        detail:
          type: string
          description: |-
            Detailgrad der Bildanalyse

            - `low`: Niedriger Detailgrad
            - `high`: Hoher Detailgrad
            - `xhigh`: Sehr hoher Detailgrad
          enum:
            - low
            - high
            - xhigh
        image_pixel_limit:
          type: object
          nullable: true
          description: >-
            Bildpixelbereichsbegrenzung


            Hat Vorrang vor dem detail-Feld. Pixelbereich muss in [196,
            36000000] liegen
          properties:
            max_pixels:
              type: integer
              description: |-
                Maximale Pixelbegrenzung

                - doubao-seed-1.8 und frueher: (min_pixels, 4014080]
                - doubao-seed-2.0: (min_pixels, 9031680]
            min_pixels:
              type: integer
              description: |-
                Minimale Pixelbegrenzung

                - doubao-seed-1.8 und frueher: [3136, max_pixels)
                - doubao-seed-2.0: [1764, max_pixels)
    InputVideo:
      title: Videoeingabe
      type: object
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - input_video
          description: Eingabetyp, fester Wert input_video
        video_url:
          type: string
          description: Video-URL oder Base64-kodierte Data-URL
        file_id:
          type: string
          description: >-
            Ueber Files API hochgeladene Datei-ID


            **Hinweis**: Bei Verwendung von file_id wird der fps-Parameter
            unwirksam
        fps:
          type: number
          description: |-
            Frame-Extraktionsrate

            - Wertebereich: [0.2, 5]
            - Hoehere Werte: Empfindlicher gegenueber Bildaenderungen
            - Niedrigere Werte: Weniger Token-Verbrauch, schneller
          minimum: 0.2
          maximum: 5
    InputFile:
      title: Dateieingabe
      type: object
      required:
        - type
      description: Derzeit werden nur PDF-Dateien unterstuetzt
      properties:
        type:
          type: string
          enum:
            - input_file
          description: Eingabetyp, fester Wert input_file
        file_id:
          type: string
          description: Ueber Files API hochgeladene Datei-ID
        file_data:
          type: string
          description: Base64-Kodierung des Dateiinhalts (einzelne Datei max. 50MB)
        filename:
          type: string
          description: Dateiname (erforderlich bei Verwendung von file_data)
        file_url:
          type: string
          description: Zugaengliche URL der Datei (Datei max. 50MB)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Alle APIs erfordern Bearer-Token-Authentifizierung##


        **API-Schluessel erhalten:**


        Besuchen Sie die
        [API-Schluesselverwaltungsseite](https://evolink.ai/dashboard/keys), um
        Ihren API-Schluessel zu erhalten


        **Zum Anfrage-Header hinzufuegen:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````