API SummitCli

Consulte os modelos disponíveis (sem autenticação) e faça a primeira chamada com sua API Key.

1
2
3
4
5
6
7
8
9
10
11
# 1. Descubra os modelos (não exige autenticação)
curl https://api.summitcli.tech/api/v1/models
# 2. Faça uma chamada com sua API Key
curl https://api.summitcli.tech/api/v1/chat/completions \
  -H 'Authorization: Bearer sk-summit-...' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "SLUG_DO_MODELO",
    "messages": [{"role": "user", "content": "Olá"}]
  }'

A API usa dois mecanismos diferentes, e cada grupo de endpoints exige um deles. Este é o ponto que mais gera erro de integração.

sk-summit-3kJ9xQmR2vB8nT5wL0pZaYdHcE4uFgN1sIoO7rCjXl
└─┬───┘└────────────┬─────────────┘
   │                └─ 32 bytes aleatórios em base64url
   └─ prefixo fixo

A criação acontece no painel autenticado (cookie de sessão), não por API Key:

1
2
3
4
5
curl -X POST https://api.summitcli.tech/api/v1/keys \
  -H 'Content-Type: application/json' \
  -H 'Origin: https://summitcli.tech' \
  -b 'summit_session=SEU_COOKIE_DE_SESSAO' \
  -d '{"name":"Meu backend"}'

Para restringir a chave a modelos específicos, mande modelIds (UUIDs que saem de GET /api/v1/models). Omitir significa que ela vale para todos os modelos ativos.

POST /api/v1/chat/completions é o endpoint principal. Exige chave ativa, um modelo liberado para ela e um plano recorrente ativo.

Corpos acima de 1 MB são recusados com 413.

Com "stream": true a resposta vem como text/event-stream e os tokens chegam conforme são gerados, em vez de tudo de uma vez.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
import os
from openai import OpenAI
client = OpenAI(
    api_key=os.environ["SUMMIT_API_KEY"],
    base_url="https://api.summitcli.tech/v1",
)
stream = client.chat.completions.create(
    model="SLUG_DO_MODELO",
    messages=[{"role": "user", "content": "Escreva um haiku sobre TypeScript"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

O gateway e o painel usam dois formatos diferentes, de propósito. O gateway segue o OpenAI; o painel usa um envelope próprio.

{
  "error": {
    "message": "API key inválida.",
    "type": "invalid_request_error"
  }
}

{
  "success": false,
  "error": {
    "code": "SUBSCRIPTION_REQUIRED",
    "message": "Você ainda não possui um plano ativo."
  },
  "meta": { "timestamp": "..." }
}

Se seu código normaliza erros, trate os dois. O code do envelope é estável e serve para lógica de controle; a mensagem é para humanos e pode mudar.

1
2
3
4
5
6
7
8
9
10
11
12
import time
import urllib.error
MAX_TENTATIVAS = 5
for tentativa in range(MAX_TENTATIVAS):
    try:
        return chamar_api()
    except urllib.error.HTTPError as erro:
        # 429 é transiente. 401/402/403 são permanentes: retry só gasta cota.
        if erro.code != 429 or tentativa == MAX_TENTATIVAS - 1:
            raise
        time.sleep(2 ** tentativa)  # 1s, 2s, 4s, 8s...

Clique em um endpoint para ver a descrição.

• A chave está em variável de ambiente, nunca no código ou no git
• Uma chave por ambiente (prod / staging), para revogação independente
• Você consulta GET /api/v1/models em vez de assumir o slug do modelo
• Você trata 402 como "precisa de assinatura", não como bug
• Você faz backoff em 429; não retenta em 401/402/403
• Em streaming, você descarta a linha data: [DONE]
• Assinatura ativa antes de tráfego real — 402 não gasta o saldo, mas não gera resposta
• Saldo monitorado — saldo zerado vira 403 no meio do fluxo