Chat Completions

Contrato de requisição

Envie de 1 a 128 mensagens ordenadas dos tipos system, user, assistant ou tool. Use max_tokens ou max_completion_tokens, nunca ambos. Cada requisição é limitada pelo teto configurado do modelo e pelos limites compartilhados de entrada serializada.

Chamadas de função

Há suporte a até oito funções declaradas e resultados de chamadas com limites. tool_choice pode ser auto, none, required ou uma função nomeada. O cliente executa as funções retornadas; uma função chamada shell nunca autoriza execução nos hosts do NotHoly.

Streaming

Defina stream:true. Os chunks preservam um ID estável e fragmentos indexados de argumentos de ferramentas. include_usage emite um chunk final somente com uso. [DONE] aparece apenas após a conclusão bem-sucedida; uma saída parcial pode ser seguida por um erro.

Resposta e limitações

Leia choices[0].message e finish_reason. O conteúdo pode ser null em turnos apenas com ferramentas. Campos desconhecidos e ciclos de ferramentas malformados falham antes do despacho. Os campos opcionais de esforço, amostragem e formato de resposta exigem um recurso do modelo explicitamente ativado; o schema gerado documenta seu formato exato aceito.

Exemplo de requisição

Use sua chave de cliente e um modelo publicado. Copiar um exemplo não envia uma requisição.

curl https://api.notholy.com/v1/chat/completions \
  -H "Authorization: Bearer $NOTHOLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "notholy-pulse",
  "messages": [
    {
      "role": "user",
      "content": "Explain least privilege."
    }
  ],
  "max_tokens": 256
}'

Campos de requisição

Gerado a partir do contrato versionado. As regras de refinamento acima continuam valendo.

Schema da resposta