Zum Hauptinhalt springen
POST
/
v1
/
responses
curl --request POST \
  --url https://api.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seed-2.0-pro",
  "input": "Bitte stellen Sie sich vor"
}
'
{
  "id": "resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e",
  "object": "response",
  "created_at": 1771486674,
  "model": "doubao-seed-2-0-pro-260215",
  "status": "completed",
  "output": [
    {
      "id": "rs_0217****404a",
      "type": "reasoning",
      "summary": [
        {
          "text": "<string>",
          "type": "summary_text"
        }
      ],
      "status": "completed"
    }
  ],
  "service_tier": "default",
  "instructions": "<string>",
  "previous_response_id": "<string>",
  "max_output_tokens": 32768,
  "temperature": 123,
  "top_p": 123,
  "thinking": {},
  "tools": "<array>",
  "tool_choice": "<unknown>",
  "parallel_tool_calls": true,
  "text": {},
  "usage": {
    "input_tokens": 88,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 230,
    "output_tokens_details": {
      "reasoning_tokens": 211
    },
    "total_tokens": 318
  },
  "caching": {
    "type": "enabled"
  },
  "store": true,
  "expire_at": 1756539922,
  "error": {},
  "incomplete_details": {}
}

Autorisierungen

​
Authorization
string
header
erforderlich

##Alle APIs erfordern Bearer-Token-Authentifizierung##

API-Schluessel erhalten:

Besuchen Sie die API-Schluesselverwaltungsseite, um Ihren API-Schluessel zu erhalten

Zum Anfrage-Header hinzufuegen:

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
model
enum<string>
Standard:doubao-seed-2.0-pro
erforderlich

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
Verfügbare Optionen:
doubao-seed-2.0-pro,
doubao-seed-2.0-lite,
doubao-seed-2.0-mini,
doubao-seed-2.0-code
​
input
erforderlich

Eingabeinhalt, unterstuetzt reinen Text oder Nachrichtenliste

​
instructions
string | null

Systemanweisungen, definieren das Verhalten und die Rolle der KI

Aehnlich wie system-Rolle in der Chat Completions API

​
previous_response_id
string | null

ID der vorherigen Antwort fuer Mehrrunden-Konversation

Der Server laedt automatisch den Kontext der vorherigen Konversation

​
stream
boolean
Standard:false

Ob Streaming-Ausgabe aktiviert werden soll

​
thinking
object

Steuert, ob das Modell den Tiefes-Denken-Modus aktiviert

​
max_output_tokens
integer | null

Maximale Ausgabe-Token-Anzahl des Modells

Wertebereich: [1, 65536]

Erforderlicher Bereich: 1 <= x <= 65536
​
temperature
number | null
Standard:1

Sampling-Temperatur, steuert die Zufaelligkeit der Ausgabe

Wertebereich: [0, 2]

Erforderlicher Bereich: 0 <= x <= 2
​
top_p
number | null
Standard:0.7

Nucleus-Sampling-Wahrscheinlichkeitsschwelle

Wertebereich: [0, 1]

Erforderlicher Bereich: 0 <= x <= 1
​
reasoning_effort
enum<string> | null

Begrenzt den Denkaufwand

  • minimal: Denken deaktiviert
  • low: Leichtes Denken
  • medium: Ausgewogener Modus
  • high: Tiefenanalyse
Verfügbare Optionen:
minimal,
low,
medium,
high
​
store
boolean
Standard:true

Ob die Antwort serverseitig gespeichert werden soll

Muss true sein, um previous_response_id zu verwenden

​
caching
object

Cache-Konfiguration zur Kostensenkung

​
text
object

Textausgabeformat des Modells festlegen

​
tools
object[]

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
​
tool_choice

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

Verfügbare Optionen:
none,
auto,
required
​
max_tool_calls
integer

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

Erforderlicher Bereich: 1 <= x <= 10
​
context_management
object

Kontextverwaltungsstrategie, hilft dem Modell das Kontextfenster effektiv zu nutzen

Antwort

Antwortgenerierung erfolgreich

​
id
string

Eindeutige Kennung dieser Antwort

Beispiel:

"resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e"

​
object
enum<string>

Objekttyp, fester Wert response

Verfügbare Optionen:
response
Beispiel:

"response"

​
created_at
number

Unix-Zeitstempel der Erstellung (Sekunden)

Beispiel:

1771486674

​
model
string

Tatsaechlich verwendeter Modellname und Version

Beispiel:

"doubao-seed-2-0-pro-260215"

​
status
enum<string>

Antwortstatus

  • completed: Generierung abgeschlossen
  • in_progress: Generierung laeuft
  • incomplete: Unvollstaendig
  • failed: Fehlgeschlagen
Verfügbare Optionen:
completed,
in_progress,
incomplete,
failed
Beispiel:

"completed"

​
output
(Chain-of-Thought-Ausgabe · object | Nachrichtenausgabe · object | Werkzeugaufruf-Ausgabe · object)[]

Modellausgabe-Inhaltsliste, einschliesslich Chain-of-Thought, Nachrichtenausgabe, Werkzeugaufruf-Ausgabe usw.

​
service_tier
string

Service-Stufe dieser Anfrage

  • default: Standard-Service-Stufe
  • scale: Garantiepaket-Kontingent verwendet
Beispiel:

"default"

​
instructions
string | null

Fuer diese Anfrage verwendete Systemanweisungen

​
previous_response_id
string | null

Referenzierte vorherige Antwort-ID

​
max_output_tokens
integer

Maximale Ausgabe-Token-Anzahl des Modells

Beispiel:

32768

​
temperature
number | null

Verwendete Sampling-Temperatur

​
top_p
number | null

Verwendeter top_p-Wert

​
thinking
object

Verwendete Denkmodus-Konfiguration

​
tools
array | null

Verwendete Werkzeugliste

​
tool_choice
any | null

Verwendete Werkzeugauswahl-Konfiguration

​
parallel_tool_calls
boolean | null

Ob parallele Werkzeugaufrufe erlaubt sind

​
text
object

Textausgabeformat-Konfiguration

​
usage
object

Token-Verbrauchsstatistiken

​
caching
object

Cache-Konfiguration

​
store
boolean

Ob die Antwort gespeichert wurde

​
expire_at
integer

Speicher-Ablaufzeitpunkt (Unix-Zeitstempel)

Beispiel:

1756539922

​
error
object

Fehlerinformationen, bei Erfolg null

​
incomplete_details
object

Detaillierter Grund fuer Unvollstaendigkeit