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
- Abra platform.ismscopilot.com/keys.
- Crie uma chave. Dê-lhe um nome que reconheça mais tarde.
- Copie a chave imediatamente. Ela começa com
sk-isms-e é mostrada apenas uma vez. - 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
| Sintoma | Causa provável |
|---|---|
401 | Cabeçalho Authorization: Bearer em falta ou incorreto; chave revogada ou desconhecida |
429 / erro de estilo quota | Saldo 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.