Text Completions

Visão Geral

O endpoint POST /v1/completions fornece completação de texto puro (sem formatação de chat). Ele recebe um prompt de texto e retorna uma ou mais completações previstas. Este endpoint é útil para tarefas de geração de texto livre, preenchimento de texto e integração com sistemas legados.

Para a maioria dos casos de uso, recomendamos o endpoint Chat Completions, que oferece mais controle e suporta conversas multi-turno.

Endpoint

POST https://api.polarai.com.br/v1/completions

Parâmetros

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`model`	string	Sim	—	Modelo a ser usado (`urso-mabe`; `urso-guto` e `urso-bah` (em breve))
`prompt`	string/array	Sim	—	Texto de entrada para completação
`max_tokens`	integer	Não	256	Número máximo de tokens na resposta
`temperature`	number	Não	0.7	Controla aleatoriedade (0.0 a 2.0)
`top_p`	number	Não	1.0	Nucleus sampling (0.0 a 1.0)
`n`	integer	Não	1	Número de completações a gerar
`stream`	boolean	Não	false	Habilita streaming via SSE
`stop`	string/array	Não	null	Sequências que interrompem a geração
`presence_penalty`	number	Não	0.0	Penalidade por presença (-2.0 a 2.0)
`frequency_penalty`	number	Não	0.0	Penalidade por frequência (-2.0 a 2.0)
`logprobs`	integer	Não	null	Número de log-probabilidades a retornar
`suffix`	string	Não	null	Sufixo esperado após a completação
`seed`	integer	Não	null	Semente para reproducibilidade
`user`	string	Não	null	Identificador do usuário final

Exemplo Básico

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.polarai.com.br/v1",
    api_key="pk-your-key-here"
)

response = client.completions.create(
    model="urso-mabe",
    prompt="O Brasil é um país conhecido por sua",
    max_tokens=200,
    temperature=0.7
)

print(response.choices[0].text)

TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.polarai.com.br/v1",
  apiKey: "pk-your-key-here",
});

const response = await client.completions.create({
  model: "urso-mabe",
  prompt: "O Brasil é um país conhecido por sua",
  max_tokens: 200,
  temperature: 0.7,
});

console.log(response.choices[0].text);

curl

curl -X POST https://api.polarai.com.br/v1/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer pk-your-key-here" \
  -d '{
    "model": "urso-mabe",
    "prompt": "O Brasil é um país conhecido por sua",
    "max_tokens": 200,
    "temperature": 0.7
  }'

Formato da Resposta

{
  "id": "cmpl-abc123",
  "object": "text_completion",
  "created": 1710000000,
  "model": "urso-mabe",
  "choices": [
    {
      "index": 0,
      "text": " diversidade cultural, riqueza natural e povo acolhedor. Com uma extensão territorial...",
      "finish_reason": "length",
      "logprobs": null
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 200,
    "total_tokens": 210
  }
}

Casos de Uso

Completação de Texto

Ideal para preencher textos parciais ou gerar continuações:

response = client.completions.create(
    model="urso-mabe",
    prompt="Prezado Senhor,\n\nVenho por meio desta solicitar",
    max_tokens=300,
    temperature=0.3
)

Geração de Código

Útil para completar trechos de código:

response = client.completions.create(
    model="urso-mabe",
    prompt="# Função Python para calcular o IPTU de um imóvel\ndef calcular_iptu(valor_venal: float, aliquota: float) -> float:\n",
    max_tokens=200,
    temperature=0.2,
    stop=["\n\n"]
)

Múltiplas Completações

Gere várias alternativas de uma vez:

response = client.completions.create(
    model="urso-mabe",
    prompt="Slogan para uma padaria artesanal brasileira: ",
    max_tokens=50,
    n=3,
    temperature=1.0
)

for i, choice in enumerate(response.choices):
    print(f"Opção {i + 1}: {choice.text.strip()}")

Próximos Passos

Chat Completions — endpoint recomendado para a maioria dos usos
Streaming — receba respostas em tempo real
Batch API — processamento em lote para grandes volumes

On this page