Guias
Chat completions
Parâmetros, papéis das mensagens e formato da resposta.
POST https://api.semcensura.ia.br/v1/chat/completions gera a próxima mensagem de uma conversa.
cURL
curl https://api.semcensura.ia.br/v1/chat/completions \
-H "Authorization: Bearer $ISC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-v4.1-flash-fast", "messages": [{"role": "user", "content": "Olá!"}]}'Corpo da requisição
| Campo | Tipo | Descrição |
|---|---|---|
model | string, obrigatório | ID do modelo, por exemplo deepseek-v4.1-flash-fast. |
messages | array, obrigatório | De 1 a 100 mensagens, cada uma com role e content. |
max_completion_tokens | inteiro | Limite de tokens de saída (1 a 131072). Também aceito como max_tokens; informe só um. |
temperature | número | De 0 a 2. Valores maiores deixam a resposta mais variada. |
top_p | número | De 0 a 1. Amostragem por núcleo. |
stop | string ou array | Até 4 sequências (1 a 100 caracteres) que encerram a geração. |
stream | booleano | true para receber a resposta via SSE. Veja Streaming. |
stream_options.include_usage | booleano | Com stream=true, envia um quadro final com o uso de tokens. |
Mensagens
| Campo | Tipo | Descrição |
|---|---|---|
role | string | system, developer, user ou assistant. |
content | string | Texto da mensagem, de 1 a 50.000 caracteres. |
Campos desconhecidos são recusados
A ISC valida o corpo de forma estrita: parâmetros fora desta tabela (como
tools, response_format, n ou seed) resultam em 400 invalid_request. Veja Compatibilidade.Resposta
JSON
{
"id": "gen-...",
"object": "chat.completion",
"model": "deepseek-v4.1-flash-fast",
"created": 1763500000,
"choices": [
{
"index": 0,
"finish_reason": "stop",
"message": {
"role": "assistant",
"content": "...",
"reasoning_content": "..."
}
}
],
"usage": {
"prompt_tokens": 42,
"completion_tokens": 310,
"total_tokens": 352,
"completion_tokens_details": {
"reasoning_tokens": 180
}
}
}reasoning_content aparece em modelos de raciocínio e traz o pensamento intermediário, quando o fornecedor o expõe. finish_reason vale stop ao terminar naturalmente e length quando atinge o limite de tokens.
Cabeçalhos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
x-request-id | UUID | Identificador da chamada. Informe ao suporte. |
x-isc-billing | string | Estado da cobrança: CAPTURED (cobrada) ou PENDING_RECONCILIATION (em conciliação com o fornecedor). |
x-isc-charge-microbrl | inteiro | Valor cobrado em micro-BRL (1.000.000 = R$ 1,00). |