Sua primeira requisição

Este guia mostra, do zero, como fazer sua primeira chamada à API. Antes de começar, confirme que:

1. Você já criou uma chave de API e guardou a chave completa.
2. Você tem a Base URL: faça login no console, abra a janela "Início rápido", escolha um protocolo e copie. Os exemplos abaixo usam https://<your-base-url> como placeholder — substitua pela sua.

A plataforma fala três protocolos nativos; escolha o que preferir — a cobrança e o saldo são idênticos em todos eles.

Protocolo compatível com OpenAI (recomendação padrão)

Totalmente compatível com o SDK da OpenAI: aponte base_url para a plataforma e seu código atual continua funcionando.

cURL

curl https://<your-base-url>/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python (SDK openai)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://<your-base-url>",
)

completion = client.chat.completions.create(
    model="your-model",
    messages=[{"role": "user", "content": "Hello"}],
)
print(completion.choices[0].message.content)

Node.js (SDK openai)

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://<your-base-url>",
})

const completion = await client.chat.completions.create({
  model: "your-model",
  messages: [{ role: "user", content: "Hello" }],
})
console.log(completion.choices[0].message.content)

Protocolo Anthropic

Isomórfico à API Messages da Anthropic: autentique com x-api-key e envie anthropic-version:

curl https://<your-base-url>/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Protocolo Gemini

Isomórfico à API Google GenAI: o ID do modelo vai no caminho e a autenticação usa x-goog-api-key:

curl "https://<your-base-url>/v1beta/models/your-model:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'

Verifique o resultado

Uma requisição bem-sucedida retorna a resposta do modelo (no protocolo OpenAI, ela está em choices[0].message.content). A partir daí você pode:

• Conferir o uso e a variação de saldo na página "Uso" do console;
• Substituir your-model por um ID real da vitrine de modelos (as modalidades texto, imagem, áudio, vídeo e arquivo são suportadas).

Erros comuns na primeira chamada

Dicas para produção: guarde a chave em uma variável de ambiente (por exemplo OPENAI_API_KEY) em vez de deixá-la fixa no código, e prefira o SDK oficial a chamadas HTTP escritas à mão — o SDK absorve os detalhes de compatibilidade do protocolo.