Beam 1.0 API

reflection/beam-1.0/chat

Beam 1.0, da Reflection, foi criado para tarefas de programação e fluxos prolongados com ferramentas. Esta API de chat aceita texto, oferece um orçamento de entrada de 1,048,576 tokens e aceita max_tokens até 943,718. Receba o texto do Beam 1.0 conforme é gerado ou use o resultado de uma função como base para a próxima etapa de as sessões longas de programação com Beam 1.0.

Entrada $1Saída $3por 1 milhão de tokensEntrada em cache $0.10

Executar modelo Ver API

Enviar uma requisição

Os exemplos usam as definições públicas de parâmetros do endpoint selecionado. Troque a chave de API e as mídias de exemplo e envie a requisição a partir do seu servidor.

SDKs e integrações

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

Autenticação da API

Guarde a chave de API na variável de ambiente do servidor SPICY_API_KEY. Use autenticação Bearer e Content-Type: application/json nas requisições 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'

Gerado a partir do schema de entrada deste modelo — o mesmo que a API usa para validar cada requisição.

Use um Idempotency-Key para cada requisição lógica. Depois de uma interrupção de rede, não reenvie automaticamente com uma chave nova; guarde o request_id para investigar a requisição aceita. A idempotência não reproduz um stream de chat anterior.

Parâmetros de entrada

Coloque os parâmetros do modelo direto no corpo JSON da requisição, ao lado de model. Este endpoint não usa um objeto input.

messagesarray<object>Obrigatório

Para as sessões longas de programação com Beam 1.0, envie a conversa e as fontes em texto na ordem e vincule cada resultado de ferramenta ao tool_call_id original.

Valor padrão: Não especificado
Restrições: minItems:1
maxItems:256

messages[].rolestringObrigatório no objeto

Role of the message author.

Valor padrão: Não especificado
Valores permitidos: "system""developer""user""assistant""tool"

messages[].namestringOpcional

Optional name identifying the speaker within its role.

Valor padrão: Não especificado

messages[].contentstring | array | nullOpcional

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

Valor padrão: Não especificado

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

Tool calls the assistant requested in this message.

Valor padrão: Não especificado

messages[].tool_call_idstringOpcional

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

Valor padrão: Não especificado

messages[].reasoning_contentstringOpcional

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

Valor padrão: Não especificado

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

Peça texto ou JSON estruturado ao Beam 1.0 e valide os campos necessários para as sessões longas de programação com Beam 1.0 antes de usá-los.

Valor padrão: Não especificado

tool_choicestring | objectOpcional

Escolha auto, none, required ou uma função específica para Beam 1.0 e preserve o ID retornado para continuar as sessões longas de programação com Beam 1.0.

Valor padrão: Não especificado

parallel_tool_callsbooleanOpcional

Permita que o Beam 1.0 proponha funções independentes juntas quando as sessões longas de programação com Beam 1.0 exigir vários resultados externos.

Valor padrão: true

toolsarray<object>Opcional

Forneça ao Beam 1.0 funções no formato OpenAI para as sessões longas de programação com Beam 1.0; o modelo propõe argumentos e seu aplicativo valida e executa a operação.

Valor padrão: Não especificado
Restrições: maxItems:128

top_pnumberOpcional

Use top_p para a amostragem nucleus do Beam 1.0; ao ajustar as sessões longas de programação com Beam 1.0, altere esse valor e temperature separadamente para identificar o efeito.

Valor padrão: Não especificado
Restrições: minimum:0.01
maximum:1

temperaturenumberOpcional

O Beam 1.0 aceita temperature de 0 a 2; mantenha os outros controles de amostragem fixos ao comparar formulações para as sessões longas de programação com Beam 1.0.

Valor padrão: Não especificado
Restrições: minimum:0
maximum:2

stopstring | arrayOpcional

Encerre o texto do Beam 1.0 em uma sequência de parada ou em qualquer uma de até quatro; a sequência encontrada fica fora da resposta.

Valor padrão: Não especificado
Restrições: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOpcional

O Beam 1.0 oferece low, medium, high, xhigh, max, com medium por padrão; compare níveis para as sessões longas de programação com Beam 1.0, pois um raciocínio mais profundo pode aumentar os tokens de saída e a espera.

Valor padrão: "medium"
Valores permitidos: "low""medium""high""xhigh""max"

max_tokensintegerOpcional

Reserve max_tokens para a resposta visível e o raciocínio cobrado do Beam 1.0 juntos; o padrão é 4096, o máximo é 943718 e ampliar o limite não muda a tarifa por token.

Valor padrão: 4096
Restrições: 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
}

Ler resultado

Com stream em false, a requisição já devolve a resposta completa: leia choices[].message, sem consultar tarefa nenhuma. Coloque stream em true se o seu cliente aceita Server-Sent Events.

Exemplo de resposta concluída

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

Esta resposta serve só para mostrar o formato. usage traz a contagem de tokens; o consumo e a cobrança reais dependem da sua requisição.

SDKs e integrações

Use a SpicyAPI no seu app, terminal, assistente de IA ou fluxo visual. Escolha um guia de configuração.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Comandos de terminal e scripts de automação.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instruções reutilizáveis para seu assistente de IA.

n8n

Nós comunitários para instalações próprias e modelos importáveis com HTTP Request para n8n Cloud.

ComfyUI

Fluxos de imagem, vídeo e áudio em um canvas de nós.

Mais integrações

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

Explorar fluxos prontos para usar

É um modelo de chat, então funciona onde a API de chat da OpenAI funciona: mantenha seu cliente, troque a URL base e escolha este modelo pelo identificador.

Aponte qualquer cliente compatível com OpenAI para cá

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

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

Qualquer ferramenta compatível com a API de chat da OpenAI funciona da mesma forma: SDKs, Vercel AI SDK, LangChain, aider e Cline. O servidor MCP e o CLI spicyapi atendem tarefas de mídia assíncronas. A configuração de cada ferramenta está no hub de desenvolvimento.

Use no SillyTavern e em apps de roleplay

No SillyTavern, RisuAI, Agnai ou qualquer app com configuração compatível com OpenAI, cole a URL base abaixo e sua chave de API e escolha reflection/beam-1.0/chat como modelo. Chamadas direto do navegador são aceitas, e controles que este modelo não suporta são ignorados em vez de recusados.

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

Guia do SillyTavern RisuAI, Agnai e outros Extensão do SillyTavern

Use no ComfyUI

Instale os nós da SpicyAPI pelo ComfyUI Manager ou com o comando abaixo e escolha reflection/beam-1.0/chat no nó SpicyAPI Chat para usar este modelo em um grafo do ComfyUI.

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

Exemplos de fluxos de trabalho Guia de configuração Código-fonte no GitHub

O painel incorporado lê o mesmo schema desta página, então não tem como sair de sincronia com a API. Se a sua documentação precisar de conteúdo indexável, pegue o JSON em /api/embed/models/ e renderize por conta própria.

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

Abrir o painel

Playground

Enviar uma requisição

Autenticação da API

Parâmetros de entrada

Ler resultado

SDKs e integrações

Use no SillyTavern e em apps de roleplay

Use no ComfyUI