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.

Faturação por utilização · Mesmo token da API Caravela

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.

Python
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.

ModeloEntradaEntrada (cache)Saída
Caravela Code
Entrada1,00 €por 1M tokens
Entrada (cache)0,15 €por 1M tokens
Saída3,00 €por 1M tokens

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.

Caravela Code · OpenAI-compatible · Retenção zero · UE