Guia de início rápido para desenvolvedores

Pré-requisitos: sua chave de API

Gere sua chave imediatamente após fazer login. Acesse a página Obter chave da API e autentique-se com Google ou senha de e-mail. A interface exibe sua chave exclusiva instantaneamente, sem necessidade de número de telefone. Mantenha essa string segura, pois ela autentica todas as solicitações para a URL base. Você recebe $0,50 de crédito de teste automaticamente, que expira em sete dias se não for utilizado.

Configurando Cursor para compatibilidade com OpenAI

Aponte seu cliente para nosso endpoint específico para garantir o roteamento correto. Defina a URL base para HTTPS://api.keyapicursor.com/v1 e insira sua chave no cabeçalho de autorização. Esta configuração funciona com qualquer SDK compatível com OpenAI sem modificar o nome do modelo. Você deve especificar o identificador do modelo como uncensored para receber a saída de peso aberto.

Enviando sua primeira solicitação

Execute uma conclusão básica para verificar a conectividade e a latência. Use o comando curl abaixo para enviar um prompt básico ao endpoint de conclusões de chat. A resposta retorna um objeto JSON contendo o texto gerado. Verifique o campo de uso para confirmar se o consumo de tokens corresponde às suas expectativas.

Lidando com respostas de streaming

Transmita tokens para menor latência percebida em aplicativos interativos. O servidor envia Server-Sent Events contendo deltas parciais até que o último bloco inclua os dados de uso total. Analise esses eventos para atualizar sua interface do usuário em tempo real. Este método funciona de forma idêntica em clientes Python e Node.

Integração com SDKs Python e Node

Reutilize bases de código existentes ajustando apenas os parâmetros de URL base e chave. O snippet em Python demonstra integração direta com a biblioteca oficial de clientes. O exemplo Node segue o mesmo padrão para ambientes JavaScript. Ambos os métodos suportam modo JSON e chamada de funções nativamente.

Compreendendo os limites de taxa e os tokens

Monitore o volume de suas requisições para evitar interrupções no serviço durante uso intenso. O sistema impõe um limite de 300 requisições por minuto por chave. Você pode executar oito requisições simultâneas com um limite de corpo de 8 MB. Erros como chaves inválidas 401 ou crédito insuficiente 402 não consomem seu saldo pré-pago.

cURL

Copycurl https://api.keyapicursor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in function parseData"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)