Beam 1.0 API

reflection/beam-1.0/chat

Beam 1.0 von Reflection unterstützt Programmierung und mehrstufige Werkzeugabläufe. Die Chat-API verarbeitet Text, bietet ein Eingabebudget von 1,048,576 Token und akzeptiert max_tokens bis 943,718. Streamen Sie den Text von Beam 1.0 sofort oder nutzen Sie ein Funktionsergebnis als Grundlage für den nächsten Schritt bei lange Programmieraufgaben mit Beam 1.0.

Eingabe $1Ausgabe $3je 1 Mio. TokenEingabe aus dem Cache $0.10

Modell ausführen API ansehen

Anfrage senden

Die Beispiele verwenden die öffentlichen Parameter des gewählten Endpunkts. Ersetzen Sie API-Schlüssel und Beispielmedien und senden Sie die Anfrage von Ihrem Server.

SDKs & Integrationen

POSThttps://api.spicyapi.ai/v1/chat/completions

API-Authentifizierung

Bewahren Sie den API-Schlüssel serverseitig in der Umgebungsvariablen SPICY_API_KEY auf. Verwenden Sie Bearer-Authentifizierung und für JSON-Anfragen Content-Type: application/json.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "reflection/beam-1.0/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Erzeugt aus dem Eingabeschema dieses Modells – genau dem, gegen das die API jede Anfrage prüft.

Behalten Sie für jede logische Anfrage denselben Idempotency-Key. Senden Sie nach einem Verbindungsabbruch nicht automatisch mit einem neuen Key erneut, sondern bewahren Sie die request_id auf, um die angenommene Anfrage zu prüfen. Ein früherer Chat-Stream wird dabei nicht noch einmal ausgeliefert.

Eingabeparameter

Die Modellparameter stehen direkt im JSON-Request-Body auf derselben Ebene wie model. Dieser Endpunkt verwendet kein input-Objekt.

messagesarray<object>Erforderlich

Übergeben Sie für lange Programmieraufgaben mit Beam 1.0 Gespräch und Belege chronologisch als Text und ordnen Sie jedes Werkzeugergebnis seiner ursprünglichen tool_call_id zu.

Standardwert: Nicht festgelegt
Einschränkungen: minItems:1
maxItems:256

messages[].rolestringIm Objekt erforderlich

Role of the message author.

Standardwert: Nicht festgelegt
Zulässige Werte: "system""developer""user""assistant""tool"

messages[].namestringOptional

Optional name identifying the speaker within its role.

Standardwert: Nicht festgelegt

messages[].contentstring | array | nullOptional

Message content, either plain text or a list of content parts.

Standardwert: Nicht festgelegt

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Optional

Tool calls the assistant requested in this message.

Standardwert: Nicht festgelegt

messages[].tool_call_idstringOptional

Identifier of the tool call this message answers. Required on tool messages.

Standardwert: Nicht festgelegt

messages[].reasoning_contentstringOptional

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Standardwert: Nicht festgelegt

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobjectOptional

Fordern Sie bei Beam 1.0 Text oder strukturiertes JSON an und prüfen Sie vor der Verwendung die für lange Programmieraufgaben mit Beam 1.0 benötigten JSON-Felder.

Standardwert: Nicht festgelegt

tool_choicestring | objectOptional

Wählen Sie für Beam 1.0 auto, none, required oder eine bestimmte Funktion und bewahren Sie die zurückgegebene Aufruf-ID für lange Programmieraufgaben mit Beam 1.0 auf.

Standardwert: Nicht festgelegt

parallel_tool_callsbooleanOptional

Erlauben Sie Beam 1.0, unabhängige Funktionen gemeinsam vorzuschlagen, wenn lange Programmieraufgaben mit Beam 1.0 mehrere externe Ergebnisse benötigt.

Standardwert: true

toolsarray<object>Optional

Geben Sie Beam 1.0 Funktionsdefinitionen im OpenAI-Format für lange Programmieraufgaben mit Beam 1.0; das Modell schlägt Argumente vor, Ihre Anwendung prüft sie und führt die Operation aus.

Standardwert: Nicht festgelegt
Einschränkungen: maxItems:128

top_pnumberOptional

Nutzen Sie top_p als Nucleus-Sampling-Regler von Beam 1.0; ändern Sie für lange Programmieraufgaben mit Beam 1.0 diesen Wert und temperature getrennt, damit der Effekt erkennbar bleibt.

Standardwert: Nicht festgelegt
Einschränkungen: minimum:0.01
maximum:1

temperaturenumberOptional

Beam 1.0 akzeptiert temperature von 0 bis 2; halten Sie beim Formulierungsvergleich für lange Programmieraufgaben mit Beam 1.0 andere Samplingwerte konstant.

Standardwert: Nicht festgelegt
Einschränkungen: minimum:0
maximum:2

stopstring | arrayOptional

Beenden Sie den Text von Beam 1.0 an einer angegebenen Stoppfolge oder einer von bis zu vier Folgen; die passende Folge selbst erscheint nicht in der Antwort.

Standardwert: Nicht festgelegt
Einschränkungen: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOptional

Beam 1.0 bietet low, medium, high, xhigh, max, standardmäßig medium; vergleichen Sie die Stufen für lange Programmieraufgaben mit Beam 1.0, da gründlicheres Denken Ausgabetokens und Wartezeit erhöhen kann.

Standardwert: "medium"
Zulässige Werte: "low""medium""high""xhigh""max"

max_tokensintegerOptional

Planen Sie sichtbare Antwort und berechnete Überlegungen von Beam 1.0 gemeinsam in max_tokens ein; Standard ist 4096, Maximum 943718, ohne Änderung des Tokenpreises durch ein höheres Limit.

Standardwert: 4096
Einschränkungen: minimum:1
maximum:943718

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "maxLength": 32,
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 80,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 4096,
      "maximum": 943718,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "maximum": 2,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "low",
        "medium",
        "high",
        "xhigh",
        "max"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "medium",
      "description": "How much reasoning the model spends before answering."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-input-token-limit": 1048576,
  "additionalProperties": false,
  "x-max-tokens-includes-reasoning": true
}

Ergebnis auslesen

Mit stream: false liefert die Anfrage die vollständige Chat-Antwort direkt zurück. Lesen Sie choices[].message; ein Auftrag muss dafür nicht abgefragt werden. Für Clients mit Unterstützung für Server-Sent Events können Sie stream auf true setzen.

Beispiel einer fertigen Antwort

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "reflection/beam-1.0/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Die Antwort dient als Strukturbeispiel. usage enthält Tokenzahlen; tatsächlicher Verbrauch und Kosten hängen von der Anfrage ab.

SDKs & Integrationen

Nutzen Sie SpicyAPI in Ihrer App, im Terminal, mit KI-Assistenten oder in visuellen Workflows. Wählen Sie die passende Anleitung.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Terminalbefehle und Automatisierungsskripte.

MCP

Claude Code · Cursor · Codex

Agent Skill

Wiederverwendbare Anweisungen für Ihren KI-Assistenten.

n8n

Community-Nodes für selbst gehostetes n8n und importierbare HTTP Request-Vorlagen für n8n Cloud.

ComfyUI

Bild-, Video- und Audio-Workflows auf einer Node-Oberfläche.

Weitere Integrationen

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Fertige Workflows entdecken

Ein Chat-Modell: Es läuft überall dort, wo die Chat-API von OpenAI läuft. Client behalten, Base-URL austauschen, dieses Modell über seine ID auswählen.

Jeden OpenAI-kompatiblen Client hierher zeigen lassen

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/reflection/beam-1.0/chat

Alles, was die OpenAI-Chat-API nutzt, funktioniert auf dieselbe Weise – SDKs, das Vercel AI SDK, LangChain, aider und Cline. Der MCP-Server und die spicyapi-CLI decken asynchrone Medienaufgaben ab. Die Einrichtung der einzelnen Tools finden Sie im Entwicklerbereich.

In SillyTavern und Rollenspiel-Apps nutzen

In SillyTavern, RisuAI, Agnai oder jeder App mit OpenAI-kompatibler Einstellung fügen Sie die Basis-URL unten und Ihren API-Schlüssel ein und wählen reflection/beam-1.0/chat als Modell. Aufrufe direkt aus dem Browser sind erlaubt, und Regler, die dieses Modell nicht kennt, werden ignoriert statt abgelehnt.

Base URL: https://api.spicyapi.ai/v1
Model: reflection/beam-1.0/chat

SillyTavern-Anleitung RisuAI, Agnai und mehr SillyTavern-Erweiterung

In ComfyUI nutzen

Installieren Sie die SpicyAPI-Nodes über den ComfyUI Manager oder mit dem Befehl unten und wählen Sie im SpicyAPI Chat-Node reflection/beam-1.0/chat, um dieses Modell in einem ComfyUI-Graphen zu nutzen.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Workflow-Beispiele Einrichtungsanleitung Quellcode auf GitHub

Das eingebettete Panel liest dasselbe Schema wie diese Seite und kann daher nicht von der API abweichen. Soll der Inhalt in Ihrer Dokumentation durchsuchbar bleiben, holen Sie stattdessen das JSON unter /api/embed/models/ und rendern es selbst.

<iframe src="https://spicyapi.ai/embed/de/models/reflection-beam-1-0/api?model=reflection%2Fbeam-1.0%2Fchat" width="100%" height="560" loading="lazy" title="Anfragebeispiel" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Panel öffnen

Playground

Anfrage senden

API-Authentifizierung

Eingabeparameter

Ergebnis auslesen

SDKs & Integrationen

In SillyTavern und Rollenspiel-Apps nutzen

In ComfyUI nutzen