CARAVELA CODE
API de código para IDEs e agentes.
Endpoint OpenAI-compatible para programação, refatoração e loops de agentes — com o mesmo token da API Caravela e processamento na Europa.
REFERÊNCIA RÁPIDA
O que precisa para ligar
base_url
https://api.caravela.chat/api/code/v1
model
caravela
Authorization
Bearer amalia_live_<token>
EXEMPLO
Configure em minutos.
Altere base_url e api_key no SDK OpenAI — ou use cURL. O modelo exposto é sempre caravela.
from openai import OpenAI
client = OpenAI(
base_url="https://api.caravela.chat/api/code/v1",
api_key="amalia_live_SEU_TOKEN",
)
stream = client.chat.completions.create(
model="caravela",
messages=[
{"role": "user", "content": "Refatora esta função para validar NIF português."}
],
stream=True,
)
for chunk in stream:
part = chunk.choices[0].delta.content
if part:
print(part, end="")Compatível com OpenAI
Mesmo contrato de chat completions — model, messages, stream e tools do cliente.
Agentes e ferramentas
Históricos com tool_calls e mensagens role: "tool" para loops de agentes.
Streaming
Respostas em tempo real para IDEs, terminais e interfaces conversacionais.
Privacidade na UE
Processamento europeu, retenção zero e sem treino com os seus prompts.
PREÇOS
Sem mensalidade. Pague pelo que usar.
Sem mensalidade nem compromisso. A Caravela Code tem o mesmo preço e partilha a quota com a API Caravela.
Faturação por utilização — pague apenas pelos tokens que consumir.
COMEÇAR
Três passos
Do token ao primeiro pedido — sem infraestrutura extra.
01
Crie o token API
No perfil, gere um token amalia_live_… e guarde-o num local seguro.
02
Configure o cliente
Defina base_url=https://api.caravela.chat/api/code/v1 e o token no cabeçalho Authorization.
03
Faça o primeiro pedido
Use model: "caravela" com messages no formato OpenAI. Veja exemplos na documentação.
Comece a usar a Caravela Code.
Crie o token no perfil, aponte o cliente para /api/code/v1 e faça o primeiro pedido — ou consulte a documentação para exemplos completos.