Beam 1.0 API

reflection/beam-1.0/chat

Beam 1.0 di Reflection è pensato per attività di programmazione e flussi prolungati con strumenti. Questa API di chat accetta testo, offre un budget di input di 1,048,576 token e accetta max_tokens fino a 943,718. Ricevi il testo di Beam 1.0 mentre viene generato, oppure usa il risultato di una funzione come base per il passo successivo di le lunghe sessioni di programmazione con Beam 1.0.

Input $1Output $3per 1 milione di tokenInput in cache $0.10

Esegui il modello Vedi l’API

Invia una richiesta

Gli esempi usano le definizioni pubbliche dei parametri dell’endpoint selezionato. Sostituisci la chiave API e i media di esempio, poi invia la richiesta dal tuo server.

SDK e integrazioni

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

Autenticazione dell’API

Tieni la chiave API nella variabile d’ambiente del server SPICY_API_KEY. Per le richieste JSON usa l’autenticazione Bearer e 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'

Generato dallo schema di input di questo modello, lo stesso su cui l’API valida ogni richiesta.

Tieni una sola Idempotency-Key per ogni richiesta logica. Dopo un’interruzione di rete, non rispedire automaticamente con una chiave nuova; conserva il request_id per indagare sulla richiesta accettata. L’idempotenza non ritrasmette uno stream di chat già avvenuto.

Parametri di input

Metti i parametri del modello direttamente nel corpo JSON della richiesta, accanto a model. Questo endpoint non usa un contenitore input.

messagesarray<object>Obbligatorio

Per le lunghe sessioni di programmazione con Beam 1.0, invia conversazione e fonti come testo in ordine e collega ogni risultato dello strumento al tool_call_id originale.

Predefinito: Non specificato
Vincoli: minItems:1
maxItems:256

messages[].rolestringObbligatorio dentro l’oggetto

Role of the message author.

Predefinito: Non specificato
Valori ammessi: "system""developer""user""assistant""tool"

messages[].namestringFacoltativo

Optional name identifying the speaker within its role.

Predefinito: Non specificato

messages[].contentstring | array | nullFacoltativo

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

Predefinito: Non specificato

{
  "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>Facoltativo

Tool calls the assistant requested in this message.

Predefinito: Non specificato

messages[].tool_call_idstringFacoltativo

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

Predefinito: Non specificato

messages[].reasoning_contentstringFacoltativo

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

Predefinito: Non specificato

{
  "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_formatobjectFacoltativo

Chiedi a Beam 1.0 testo o JSON strutturato, poi verifica i campi necessari per le lunghe sessioni di programmazione con Beam 1.0 prima di usarli.

Predefinito: Non specificato

tool_choicestring | objectFacoltativo

Scegli auto, none, required o una funzione specifica per Beam 1.0, poi conserva l’ID della chiamata per proseguire le lunghe sessioni di programmazione con Beam 1.0.

Predefinito: Non specificato

parallel_tool_callsbooleanFacoltativo

Consenti a Beam 1.0 di proporre funzioni indipendenti insieme quando le lunghe sessioni di programmazione con Beam 1.0 richiede più risultati esterni.

Predefinito: true

toolsarray<object>Facoltativo

Fornisci a Beam 1.0 definizioni di funzione in formato OpenAI per le lunghe sessioni di programmazione con Beam 1.0; il modello propone argomenti e la tua applicazione li verifica ed esegue l’operazione.

Predefinito: Non specificato
Vincoli: maxItems:128

top_pnumberFacoltativo

Usa top_p per il nucleus sampling di Beam 1.0; per regolare le lunghe sessioni di programmazione con Beam 1.0, modifica questo valore e temperature separatamente per capirne l’effetto.

Predefinito: Non specificato
Vincoli: minimum:0.01
maximum:1

temperaturenumberFacoltativo

Beam 1.0 accetta temperature da 0 a 2; mantieni fissi gli altri controlli di campionamento per confrontare le formulazioni di le lunghe sessioni di programmazione con Beam 1.0.

Predefinito: Non specificato
Vincoli: minimum:0
maximum:2

stopstring | arrayFacoltativo

Termina il testo di Beam 1.0 con una sequenza o con una tra un massimo di quattro; la sequenza corrispondente resta esclusa dalla risposta.

Predefinito: Non specificato
Vincoli: minLength:1
minItems:1
maxItems:4

reasoning_effortstringFacoltativo

Beam 1.0 offre low, medium, high, xhigh, max, con medium predefinito; confronta i livelli per le lunghe sessioni di programmazione con Beam 1.0, perché un ragionamento più profondo può aumentare i token in uscita e l’attesa.

Predefinito: "medium"
Valori ammessi: "low""medium""high""xhigh""max"

max_tokensintegerFacoltativo

Prevedi insieme risposta visibile e ragionamento fatturato di Beam 1.0 in max_tokens; il valore predefinito è 4096, il massimo è 943718 e aumentare il limite non cambia la tariffa per token.

Predefinito: 4096
Vincoli: 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
}

Leggi il risultato

Con stream impostato a false la richiesta restituisce direttamente la risposta di chat completata. Leggi choices[].message; non serve interrogare nessuna attività. Imposta stream a true quando il tuo client supporta i Server-Sent Events.

Esempio di risposta completata

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

L’esempio di risposta è illustrativo. usage riporta il conteggio dei token; conteggi e addebiti dipendono dalla tua richiesta reale.

SDK e integrazioni

Usa SpicyAPI nella tua app, nel terminale, con un assistente IA o in un workflow visivo. Scegli una guida di configurazione.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Comandi da terminale e script di automazione.

MCP

Claude Code · Cursor · Codex

Agent Skill

Istruzioni riutilizzabili per il tuo assistente IA.

n8n

Nodi della community per installazioni self-hosted e template HTTP Request importabili per n8n Cloud.

ComfyUI

Workflow di immagini, video e audio su una tela a nodi.

Altre integrazioni

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

Esplora i workflow pronti all’uso

Questo è un modello di chat, quindi funziona ovunque funzioni l’API chat di OpenAI: tieni il tuo client, cambia l’URL di base e seleziona questo modello con il suo identificatore.

Punta qui qualsiasi client compatibile con OpenAI

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

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

Tutto quello che usa l’API chat di OpenAI funziona allo stesso modo: gli SDK, il Vercel AI SDK, LangChain, aider e Cline. Il server MCP e la CLI spicyapi coprono le attività multimediali asincrone. La configurazione di ciascuno strumento è nell’area sviluppatori.

Usalo in SillyTavern e nelle app di roleplay

In SillyTavern, RisuAI, Agnai o in qualsiasi app con un’impostazione compatibile con OpenAI, incolla l’URL di base qui sotto e la tua chiave API, poi scegli reflection/beam-1.0/chat come modello. Le chiamate dal browser sono consentite, e i cursori che questo modello non supporta vengono ignorati invece di essere rifiutati.

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

Guida a SillyTavern RisuAI, Agnai e altre Estensione per SillyTavern

Usalo in ComfyUI

Installa i nodi SpicyAPI da ComfyUI Manager o con il comando qui sotto, poi scegli reflection/beam-1.0/chat nel nodo SpicyAPI Chat per usare questo modello dentro un grafo di ComfyUI.

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

Esempi di workflow Guida all’installazione Codice sorgente su GitHub

Il pannello incorporato legge lo stesso schema di questa pagina, quindi non può discostarsi dall’API. Se nella tua documentazione i contenuti devono essere ricercabili, leggi il JSON sotto /api/embed/models/ e renderizzalo per conto tuo.

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

Apri il pannello

Playground

Invia una richiesta

Autenticazione dell’API

Parametri di input

Leggi il risultato

SDK e integrazioni

Usalo in SillyTavern e nelle app di roleplay

Usalo in ComfyUI