Source: https://ailoot.ai/docs/pt-pt/connect/curl/
Canonical: https://ailoot.ai/docs/pt-pt/connect/curl/
Language: pt-pt

[Ligação](https://ailoot.ai/docs/pt-pt/) 

# Pedidos HTTP (curl)

[Markdown](https://ailoot.ai/docs/pt-pt/connect/curl/index.md)

Utilização da API sem SDK: quaisquer linguagens e ferramentas que permitam enviar um pedido HTTP.

Todos os pedidos são enviados para `https://api.ailoot.ai` por HTTPS; o corpo é JSON (multipart para enviar ficheiros). A chave é transmitida num dos cabeçalhos de autorização.

Chave numa variável

```bash
export AILOOT_API_KEY="sk-..."
```

## [](https://ailoot.ai/docs/pt-pt/connect/curl/#chat)OpenAI Chat Completions

```bash
curl https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [
      {"role": "user", "content": "Explique em duas frases o que é uma API."}
    ]
  }' 
```

## [](https://ailoot.ai/docs/pt-pt/connect/curl/#stream)Resposta em fluxo

A opção `-N` desativa o buffering do curl, para que os eventos sejam apresentados logo que chegam. Cada evento começa por `data:`, e o fluxo termina com a linha `data: [DONE]`.

O Ailoot entrega a resposta de texto paga após o cálculo do custo. Por isso, com `stream: true` o formato continua a ser em fluxo (SSE), mas o texto chega num único bloco quando o modelo termina, e não palavra a palavra. Se a resposta demorar mais de cerca de 15 segundos, os fluxos Chat Completions, Responses e Messages começam por linhas de serviço `: ping` (aproximadamente a cada 10 segundos), seguidas da linha `: ailoot-charged-usd …` com o valor debitado e dos dados propriamente ditos. Os SDK ignoram essas linhas.

```bash
curl -N https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-v4-pro", "stream": true,
       "messages": [{"role": "user", "content": "Conte até cinco"}]}' 
```

## [](https://ailoot.ai/docs/pt-pt/connect/curl/#responses)OpenAI Responses

```bash
curl https://api.ailoot.ai/v1/responses \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6.1-sol", "input": "Formule um brinde para o aniversário de um colega"}' 
```

## [](https://ailoot.ai/docs/pt-pt/connect/curl/#messages)Anthropic Messages

```bash
curl https://api.ailoot.ai/v1/messages \
  -H "x-api-key: $AILOOT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Olá! O que consegue fazer?"}]
  }' 
```

## [](https://ailoot.ai/docs/pt-pt/connect/curl/#gemini)Gemini

```bash
curl "https://api.ailoot.ai/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "Crie três nomes para um café."}]}
    ]
  }' 
```

## [](https://ailoot.ai/docs/pt-pt/connect/curl/#models)Lista de modelos

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY" | jq -r '.data[].id'
```

## [](https://ailoot.ai/docs/pt-pt/connect/curl/#headers)Cabeçalhos da resposta

Acrescente `-i`para ver os cabeçalhos. `X-Request-ID` — identificador do pedido: também é indicado no texto dos erros. `X-Ailoot-Charged-USD` — valor debitado pela resposta de texto paga. Todos os cabeçalhos estão na página [Como funciona](https://ailoot.ai/docs/pt-pt/how-it-works/#headers).

Ainda tem dúvidas? Envie o Request ID e uma descrição — ajudamos a esclarecer.[Contactar o suporte](mailto:support@ailoot.ai)

## Ailoot · A empresa e a sua carteira de projetos





A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.





A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.





A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.