Configuração da API

1. Obtenha sua chave de API

Crie ou copie sua chave SI-API em Chaves de API e substitua o marcador abaixo. Chaves de API →

Variável de ambiente

export SIAPI_API_KEY="YOUR_SIAPI_API_KEY"

Antes de enviar uma requisição, confira o saldo ou a franquia disponível e sua preferência de cobrança. Como funciona a cobrança →

2. Configure a URL base

URL base

https://siapi.ai/v1

3. Envie uma requisição

ModeloEndpoint

Streaming

Chat Completions · curl

curl https://siapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek-flash",
  "messages": [
    {
      "role": "user",
      "content": "Explain binary search in one paragraph."
    }
  ],
  "max_tokens": 256
}'

A resposta contém o texto gerado. Consulte o uso de tokens e as cobranças em Uso.

4. Troque de modelo com a mesma chave

Escolha outro modelo no exemplo acima e copie a requisição atualizada. Mantenha a URL base e a chave; substitua o campo model pelo ID exato do catálogo. O exemplo atual usa deepseek-flash.

Confira os níveis de raciocínio, os tipos de entrada e os limites de saída aceitos pelo novo modelo. As ferramentas definidas pelo cliente também precisam corresponder ao protocolo selecionado. Recursos dos modelos →

Migração de outro provedor de API

Mantenha a estrutura da aplicação quando o cliente aceitar um provedor personalizado. Revise estas configurações antes de migrar um fluxo de produção.

Configurações a conferir na migração
Configuração	O que alterar ou verificar
Protocolo e URL base	SDKs OpenAI: use `https://siapi.ai/v1` com Chat Completions ou Responses. SDKs Anthropic: use `https://siapi.ai` com Messages. Deixe o SDK acrescentar o caminho da requisição uma única vez.
Autenticação	Substitua a chave do provedor anterior pela chave SI-API. Requisições OpenAI usam `Authorization: Bearer`; requisições Messages usam `x-api-key` e o cabeçalho `anthropic-version` mostrado no exemplo.
ID do modelo	Use um ID do catálogo, como `deepseek-flash` ou `glm-5.3-flash`. Os prefixos de provedor e os aliases de modelo do serviço anterior podem ser diferentes. IDs dos modelos →
Parâmetros específicos do modelo	Confira as configurações de raciocínio, a entrada de imagens, os limites de saída e os esquemas de ferramentas. Não reutilize parâmetros de outro modelo ou provedor que não sejam aceitos. Configuração do modelo
Configurações do cliente e do agente	Para ferramentas de programação, use a configuração multimodelo correspondente, em vez de substituir valores em um perfil de outro provedor. Siga as instruções do guia para inicialização, troca de modelo e esforço de raciocínio. Guias de agentes

Teste primeiro uma requisição pequena

Comece com uma requisição de texto curta e um limite de saída pequeno. Confirme o formato da resposta e teste o streaming e as ferramentas usadas pela aplicação. Confira o modelo, os tokens e as cobranças registrados em Uso antes de aumentar o tráfego.

O cliente precisa aceitar endpoints personalizados para se conectar diretamente. Alguns clientes exigem uma configuração própria de provedor; alterar apenas a URL não garante compatibilidade. A conexão não funciona?

Modelos e preços · A conexão não funciona?