Início Rápido

Visão Geral

Este guia mostra como começar a usar a API da Polar em poucos minutos. A API é totalmente compatível com o formato OpenAI, então você pode usar SDKs existentes com apenas uma mudança de configuração.

1. Crie sua Conta

Acesse polar-ai.com e crie sua conta. O cadastro é gratuito e você recebe créditos iniciais para testar a API.

2. Obtenha sua Chave de API

Após o cadastro, acesse o Dashboard e navegue até a seção API Keys. Crie uma nova chave — ela começa com o prefixo pk-.

Guarde sua chave em local seguro. Ela não será exibida novamente.

export POLAR_API_KEY="pk-sua-chave-aqui"

3. Instale o SDK

Escolha o SDK para sua linguagem:

Python

pip install polar-ai

TypeScript / Node.js

npm install @polar-ai/sdk

Ou use o SDK da OpenAI (compatível)

pip install openai

npm install openai

4. Primeiro Request

Python com SDK Polar

from polar_ai import PolarAI

client = PolarAI(api_key="pk-sua-chave-aqui")

response = client.chat.completions.create(
    model="urso-base",
    messages=[
        {"role": "user", "content": "O que é a LGPD e por que ela é importante?"}
    ]
)

print(response.choices[0].message.content)

Python com SDK OpenAI (compatível)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.polar-ai.com/v1",
    api_key="pk-sua-chave-aqui"
)

response = client.chat.completions.create(
    model="urso-base",
    messages=[
        {"role": "user", "content": "O que é a LGPD e por que ela é importante?"}
    ]
)

print(response.choices[0].message.content)

TypeScript

import { PolarAI } from "@polar-ai/sdk";

const client = new PolarAI({ apiKey: "pk-sua-chave-aqui" });

const response = await client.chat.completions.create({
  model: "urso-base",
  messages: [
    { role: "user", content: "O que é a LGPD e por que ela é importante?" },
  ],
});

console.log(response.choices[0].message.content);

TypeScript com SDK OpenAI (compatível)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.polar-ai.com/v1",
  apiKey: "pk-sua-chave-aqui",
});

const response = await client.chat.completions.create({
  model: "urso-base",
  messages: [
    { role: "user", content: "O que é a LGPD e por que ela é importante?" },
  ],
});

console.log(response.choices[0].message.content);

curl

curl https://api.polar-ai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer pk-sua-chave-aqui" \
  -d '{
    "model": "urso-base",
    "messages": [
      {"role": "user", "content": "O que é a LGPD e por que ela é importante?"}
    ]
  }'

5. Streaming

Para receber respostas em tempo real, use o parâmetro stream: true:

Python (streaming)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.polar-ai.com/v1",
    api_key="pk-sua-chave-aqui"
)

stream = client.chat.completions.create(
    model="urso-base",
    messages=[
        {"role": "user", "content": "Conte uma história curta sobre o Brasil."}
    ],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

TypeScript (streaming)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.polar-ai.com/v1",
  apiKey: "pk-sua-chave-aqui",
});

const stream = await client.chat.completions.create({
  model: "urso-base",
  messages: [
    { role: "user", content: "Conte uma história curta sobre o Brasil." },
  ],
  stream: true,
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content;
  if (content) {
    process.stdout.write(content);
  }
}

curl (streaming)

curl https://api.polar-ai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer pk-sua-chave-aqui" \
  -d '{
    "model": "urso-base",
    "messages": [
      {"role": "user", "content": "Conte uma história curta sobre o Brasil."}
    ],
    "stream": true
  }'

6. Usando Variáveis de Ambiente

Recomendamos usar variáveis de ambiente para não expor sua chave no código:

export POLAR_API_KEY="pk-sua-chave-aqui"

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.polar-ai.com/v1",
    api_key=os.environ["POLAR_API_KEY"]
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.polar-ai.com/v1",
  apiKey: process.env.POLAR_API_KEY,
});

Próximos Passos

Modelos — explore todos os modelos da família Urso
Comparar Modelos — escolha o modelo ideal para seu caso
SDKs e Clientes — configuração avançada dos SDKs
Chat Completions — referência completa da API

On this page