API do Claude Haiku 5.5: roleplay rápido e 1M de contexto

anthropic/claude-haiku-5.5/chat

Chat do Claude Haiku 5.5, da Anthropic, lançado em 7 de outubro de 2026, por um endpoint compatível com a OpenAI. Recebe até 1.000.000 de tokens de texto e imagens, devolve até 128.000 e aceita até 128 definições de ferramenta, com chamadas de ferramenta automáticas ou forçadas.

Entrada $0.10Saída $0.50por 1 milhão de tokensEntrada em cache $0.10Gravação em cache $0.10Prompts acima de 100K tokensEntrada $0.50Saída $2.50

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": "anthropic/claude-haiku-5.5/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

Turnos da conversa em ordem, do mais antigo ao mais recente. Os papéis são system, developer, user, assistant e tool; as mensagens system e developer viram as instruções do modelo. O conteúdo é uma string ou um array de partes de texto e image_url. O resultado de uma ferramenta vai em uma mensagem com papel tool que carrega o seu tool_call_id.

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

messages[].rolestringObrigatório no objeto

Role of the message author.

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

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"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "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": {
      "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"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "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
  },
  "minItems": 1,
  "description": "Ordered conversation turns. Text and images."
}

tool_choicestring | objectOpcional

auto (o padrão quando tools é fornecido), none, required ou uma função nomeada, como {"type": "function", "function": {"name": "route_ticket"}}. Forçar uma ferramenta nomeada é a forma de obter saída estruturada.

Valor padrão: Não especificado

parallel_tool_callsbooleanOpcional

true por padrão. Com false o modelo chama no máximo uma ferramenta por turno, o que combina com cadeias em que cada chamada depende do resultado da anterior. Só importa quando tools é fornecido.

Valor padrão: true

toolsarray<object>Opcional

Até 128 definições de função por requisição, no formato de funções da OpenAI: um nome, uma descrição e parâmetros em JSON Schema para cada uma.

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

max_tokensintegerOpcional

Aceito por compatibilidade, até 128.000; padrão 4.096. Neste endpoint ele não corta a resposta: o modelo termina quando acaba e você é cobrado pelos tokens que ele escreve, raciocínio incluído. Peça um tamanho no prompt. Não afeta a tarifa por token.

Valor padrão: 4096
Restrições: minimum:1
maximum:128000

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "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": {
          "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"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "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
      },
      "minItems": 1,
      "description": "Ordered conversation turns. Text and images."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 80,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 4096,
      "maximum": 128000,
      "minimum": 1,
      "description": "Accepted for compatibility; the reply ends when the model is done and is billed for the tokens it writes."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call: auto, none, required, or a named function."
    },
    "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-image-token-limit": 6000,
  "x-input-token-limit": 1000000,
  "additionalProperties": false,
  "x-output-token-reserve": 128000
}

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": "anthropic/claude-haiku-5.5/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/anthropic/claude-haiku-5.5/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 anthropic/claude-haiku-5.5/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: anthropic/claude-haiku-5.5/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 anthropic/claude-haiku-5.5/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/claude-haiku-5-5/api?model=anthropic%2Fclaude-haiku-5.5%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