Início rápido para usuários da Ollama

Pré-requisitos

Para usar esta API, você precisa de uma conta ativa com uma chave de API válida. Entre na página Obter chave de API usando Google ou e-mail e senha. Não é necessário número de telefone. Você também precisa de um SDK de linguagem suportado instalado. Este guia cobre Python e Node.js, os clientes mais comuns para endpoints compatíveis com OpenAI. A API serve um único modelo sem censura identificado por uncensored. Aceita texto e retorna texto. Não há embeddings, imagens ou áudio. Todas as requisições vão para https://api.ollamaapi.cc/v1.

Instalar SDK

Instale o SDK oficial para sua linguagem preferida. Para Python, use pip. Para Node.js, use npm. Essas bibliotecas lidam com protocolo HTTP, serialização JSON e streaming automaticamente. Você não precisa escrever requisições HTTP brutas, a menos que prefira esse nível de controle. Os SDKs são bem documentados e amplamente usados em produção. Certifique-se de que seu ambiente atenda aos requisitos do SDK. Python 3.8+ e Node.js 18+ são recomendados. Mantenha suas dependências atualizadas para evitar problemas de compatibilidade com novos parâmetros do modelo.

Configurar Cliente

Defina a URL base para nosso endpoint. Esta é a única alteração de configuração necessária para alternar da OpenAI para nosso serviço sem censura. Passe sua chave de API como cabeçalho de autorização. O SDK cuidará do resto. Não altere o nome do modelo para gpt-4 ou similar; use uncensored. A API segue estritamente o protocolo de chat-completions da OpenAI. Qualquer cliente que funcione com OpenAI funcionará aqui com essas duas alterações. Isso torna a migração ou testes A/B simples. Você pode executar ambas as APIs lado a lado para comparar saídas.

Enviar Primeira Requisição

Faça uma requisição POST para /v1/chat/completions. Inclua o ID do modelo, prompt do sistema e mensagem do usuário. A API retorna uma resposta de texto. Se você tiver crédito, a requisição é bem-sucedida. Se faltar crédito, você recebe um erro 402. Se sua chave for inválida, você recebe 401. Esses erros são padrão e fáceis de tratar no código. O modelo não recusa conteúdo adulto lícito, sendo útil para escrita criativa, pesquisa de segurança ou chat sem censura. Verifique seu saldo no painel se tiver dúvidas sobre créditos restantes.

Respostas em Streaming

Ative o streaming definindo stream: true. A API retorna tokens conforme são gerados. Isso reduz a latência percebida para os usuários. O fragmento final contém o uso total de tokens para faturamento. Streaming é suportado por todos os SDKs oficiais. É essencial para interfaces de chat onde você deseja mostrar o texto conforme é escrito. O servidor envia Server-Sent Events (SSE). Sua biblioteca cliente trata a análise. Você não precisa gerenciar o fluxo de eventos manualmente, a menos que esteja construindo um cliente personalizado.

Limites, Erros e Contexto

A janela de contexto tem 100.000 tokens no total, com saída máxima de 32.000 tokens. As requisições são limitadas a 300 por minuto e 8 requisições simultâneas por chave. O corpo da requisição deve ter menos de 8 MB. Os erros incluem 401 para chaves inválidas, 402 para crédito insuficiente e 429 para limites de taxa. Estes são códigos HTTP padrão. Trate-os elegantemente em sua aplicação. O modelo bloqueia conteúdo sexual envolvendo menores. Todo o outro conteúdo é permitido. O crédito nunca expira, então você pode pausar o uso sem perder fundos. Use a página de suporte para questões de reembolso.

cURL

Copycurl https://api.ollamaapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ollamaapi.cc/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamaapi.cc/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Streaming

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)