API Gemma: primeira requisição em cinco minutos

URL Base e Autenticação

Comece criando uma conta na página Obter chave de API. Você só precisa de um e-mail e senha; nenhum número de telefone ou cartão de crédito é necessário para ativar o crédito de teste grátis. Após o registro, sua chave de API é exibida imediatamente. Copie esta chave e armazene-a com segurança. Use-a no cabeçalho Authorization como token Bearer para todas as requisições. A URL base para todos os endpoints é https://api.gemma4api.com/v1. Esta URL funciona com qualquer cliente compatível com OpenAI, permitindo que você altere provedores simplesmente alterando a URL base e a chave de API na sua configuração.

Primeira Requisição

Envie seu primeiro prompt usando curl para verificar a conectividade. Substitua YOUR_API_KEY pela sua chave real. O identificador do modelo é uncensored. Esta simples solicitação de entrada de texto e saída de texto confirma que sua autenticação está correta e que o modelo está respondendo. Se você receber uma resposta JSON com uma matriz choices, sua configuração está completa. Agora você pode prosseguir para integrar o SDK para fluxos de trabalho mais complexos.

Copycurl https://api.gemma4api.com/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."}]
  }'

Integração com SDK Python

Instale o pacote oficial do OpenAI para Python. Defina as variáveis de ambiente da URL base e da chave de API ou passe-as diretamente para o construtor do cliente. Use o ID do modelo uncensored para garantir que você está chamando nossa instância específica. Esta abordagem garante que seu código permaneça compatível com os padrões padrão da OpenAI, enquanto aproveita nosso modelo sem censura para geração de conteúdo. O SDK lida com retentativas e análise JSON automaticamente.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.gemma4api.com/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)

Integração com SDK Node.js

Para ambientes JavaScript, instale o pacote OpenAI Node.js. Configure o cliente com a URL base https://api.gemma4api.com/v1 e sua chave de API. Use o ID do modelo uncensored em suas chamadas de conclusão. Esta configuração permite que você mantenha estruturas de código compatíveis com OpenAI enquanto se beneficia do comportamento específico do modelo hospedado em nossos servidores. Certifique-se de lidar corretamente com as respostas assíncronas dentro do loop de eventos do Node.js.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.gemma4api.com/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);

Respostas em Streaming

Ative o streaming definindo o parâmetro stream como true em sua requisição de API. Isso retorna um fluxo de Server-Sent Events (SSE), permitindo que você exiba tokens conforme são gerados. Isso é ideal para interfaces de chat onde a latência é importante. Cada chunk contém um delta parcial da resposta. Lidere o evento de fim do fluxo para saber quando a geração estiver completa. Este método reduz significativamente a latência percebida em comparação com o aguardo da resposta completa.

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)

Limites, Erros e Janela de Contexto

Suas requisições suportam uma janela de contexto de 100.000 tokens para prompt e conclusão combinados. O limite de requisições é de 300 requisições por minuto por chave, com um tamanho máximo de corpo de requisição de 8 MB. Erros comuns incluem 401 para chaves inválidas, 402 se seu crédito pré-pago estiver esgotado e 429 se você exceder o limite por minuto. Regenerar sua chave de API revoga a antiga, mas não reseta o contador de taxa. Certifique-se de que seu cliente manipule esses códigos de status HTTP adequadamente para manter o funcionamento suave.