Pular para o conteúdo principal

Compatível com OpenAI

Mantenha seu código da OpenAI, troque a URL base

A SpicyAPI fala o formato de chat completions da OpenAI. Aponte qualquer SDK, framework ou app de chat compatível para a nossa URL base, use um ID de modelo do catálogo e receba as respostas em streaming como de costume.

O que é uma API compatível com OpenAI?

Ela aceita as mesmas requisições da API de chat da OpenAI. Qualquer ferramenta feita para a OpenAI fala com a SpicyAPI depois de você trocar três configurações.

  1. Seu app ou cliente de chatSDK da OpenAI, LangChain, SillyTavern…
  2. SpicyAPIapi.spicyapi.ai/v1
  3. Modelos de chat26 modelos com uma só chave
Seu código continua enviando requisições no estilo OpenAI. Só mudam o endereço, a chave e o nome do modelo.

Ideal para

  • Apps que já usam o SDK da OpenAITroque o endereço e a chave. O resto do código fica igual.
  • Apps de roleplay e chatSillyTavern, RisuAI e Agnai se conectam como um endpoint OpenAI personalizado.
  • Frameworks de agentesLangChain, Vercel AI SDK e Aider funcionam pelos adaptadores da OpenAI.

Conecte em três passos

  1. Passo 1

    Crie uma chave de API

    Entre e crie uma chave no console. Ela começa com sk-spicy-.

    header
    Authorization: Bearer sk-spicy-…
  2. Passo 2

    Troque a URL base

    Substitua o endereço da OpenAI por https://api.spicyapi.ai/v1.

    base URL
    https://api.spicyapi.ai/v1
  3. Passo 3

    Escolha um ID de modelo

    Copie um ID de modelo de chat da lista abaixo e envie sua primeira mensagem.

    model
    xai/grok-4.7/chat

Três valores para trocar

A maioria dos clientes acrescenta /chat/completions sozinha, então informe a URL base só até /v1. Apps que pedem o endpoint completo precisam de https://api.spicyapi.ai/v1/chat/completions.

Configuração para o seu cliente

Copie o trecho do SDK, framework ou app que você já usa. Clique na sua ferramenta para ir direto ao trecho.

curl https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_CATALOG",
    "messages": [{ "role": "user", "content": "Write a two-line opening scene." }],
    "stream": true
  }'

Clientes de terceiros mudam o formato de configuração entre versões. Se um trecho daqui deixar de bater com o cliente, vale a documentação dele.

Modelos de chat disponíveis

Copie o ID exatamente como aparece. Preços e limites de contexto estão na página de cada modelo.

Todos os modelos de chat (26)

Corrija os erros mais comuns

A maioria dos problemas de primeira viagem é um destes três. Cada card mostra o que você vê e a única coisa a mudar.

  • 401

    Não autorizado

    A chave está ausente, ou é uma chave da OpenAI. Envie a sua chave da SpicyAPI: Authorization: Bearer sk-spicy-…

  • 404

    Não encontrado

    A URL base está no nível errado. Use https://api.spicyapi.ai/v1, sem deixar apenas o domínio nem acrescentar /chat/completions duas vezes.

  • modelo

    Modelo não encontrado

    Nomes da OpenAI, como gpt-4o, não são aliases aqui. Use um ID completo no formato maker/model/chat.

Perguntas frequentes