ISMS Copilot Docs

Obter uma chave de API e primeira conclusão

Crie uma chave sk-isms na consola da plataforma e chame o endpoint de conclusões de chat compatível com OpenAI.

Pré-requisitos

  • Uma conta no ISMS Copilot com sessão iniciada em platform.ismscopilot.com.
  • Um saldo de créditos pré-pagos positivo (compre créditos em Credits). As conclusões debitam o saldo; um saldo vazio faz com que o pedido falhe.

1. Criar uma chave

  1. Abra platform.ismscopilot.com/keys.
  2. Crie uma chave. Dê-lhe um nome que reconheça mais tarde.
  3. Copie a chave imediatamente. Ela começa com sk-isms- e é mostrada apenas uma vez.
  4. Opcionalmente, defina limites de gastos por chave (hora / dia / semana / mês).

2. Primeiro pedido (curl)

curl https://api.ismscopilot.com/v1/chat/completions \
  -H "Authorization: Bearer sk-isms-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "isms-fast",
    "messages": [
      {"role": "user", "content": "Liste 3 requisitos de controlo de acesso da ISO 27001."}
    ]
  }'

3. OpenAI SDK (Python)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.ismscopilot.com/v1",
    api_key="sk-isms-...",
)

resp = client.chat.completions.create(
    model="isms-thinking",
    messages=[{"role": "user", "content": "Qual a diferença entre SOC 2 Tipo 1 e Tipo 2?"}],
)
print(resp.choices[0].message.content)

4. OpenAI SDK (Node)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.ismscopilot.com/v1",
  apiKey: "sk-isms-...",
});

const resp = await client.chat.completions.create({
  model: "isms-fast",
  messages: [{ role: "user", content: "Quais os artigos do GDPR que abordam o DPO?" }],
});
console.log(resp.choices[0].message.content);

5. Listar modelos

curl https://api.ismscopilot.com/v1/models \
  -H "Authorization: Bearer sk-isms-..."

Sem uma chave, o endpoint retorna 401 com um erro de autenticação. Isso é esperado.

Falhas comuns

SintomaCausa provável
401Cabeçalho Authorization: Bearer em falta ou incorreto; chave revogada ou desconhecida
429 / erro de estilo quotaSaldo de créditos vazio ou limite de gastos por chave atingido

Trate sk-isms-… como uma palavra-passe. Revogue-a na consola se for comprometida e crie uma nova.

Nesta página