Início rápido com 4-4 AI: conecte-se a uma API de IA unificada em 5 minutos

Tutorial · 2026-11-20 · 8 min de leitura

Este tutorial guia você de zero até a conexão completa com o 4-4 AI: obter a chave → configurar a Base URL → rodar a primeira saída em streaming. Tudo usa a interface compatível com OpenAI — qualquer código, framework ou ferramenta existente que aceite uma Base URL personalizada (SDK openai, LangChain, Cursor etc.) não precisa de mudanças na lógica do código, apenas na configuração.

Preparação

  1. Acesse www.4-4.vip, crie uma conta e faça login no console;
  2. Recarregue saldo no console ou resgate um código de cartão;
  3. Na página «Tokens», crie uma nova chave de API (formato sk-...) e guarde-a com cuidado — ela aparece completa apenas uma vez, na criação.
Aviso de segurança: uma chave de API equivale ao crédito da conta. Não faça commit dela em repositórios Git nem em código front-end. Prefira gerenciar com variáveis de ambiente.

Conceito central: Base URL e chave

O 4-4 AI oferece um protocolo de interface totalmente compatível com OpenAI. Você só precisa lembrar de duas configurações:

ItemValor
Base URLhttps://www.4-4.vip/v1
API KeyA chave sk-... criada na página de tokens do console
Parâmetro modelInforme o nome do modelo conforme a necessidade, ex.: deepseek-chat, glm-4 etc. (a lista de modelos do console é a referência)

Trocar de modelo = mudar só o parâmetro model; trocar de provedor = mudar só a Base URL. Esse é o valor central de um gateway unificado: desacoplar o código de negócio do provedor de modelos.

Método 1: cURL (o mais rápido para validar a conectividade)

curl https://www.4-4.vip/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $44AI_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "Introduce yourself in one sentence"}
    ]
  }'

Se o JSON retornado contém choices[0].message.content, toda a cadeia está funcionando.

Método 2: Python (SDK oficial do openai)

pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["44AI_API_KEY"],          # your 4-4 AI key
    base_url="https://www.4-4.vip/v1"            # key: point to the 4-4 AI gateway
)

# regular call
resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Write a quicksort in Python"}]
)
print(resp.choices[0].message.content)

# streaming output
stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Tell me a nerdy joke"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta
    if delta and delta.content:
        print(delta.content, end="", flush=True)

Método 3: Node.js

npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.N44_API_KEY,
  baseURL: "https://www.4-4.vip/v1",
});

const completion = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "Write a debounce function in TypeScript" }],
});
console.log(completion.choices[0].message.content);

Conectar frameworks e ferramentas principais

Perguntas frequentes (FAQ)

Erro 401 Invalid API Key?

Verifique em ordem: ① se ao copiar a chave entraram espaços ou quebras de linha; ② se a chave está desativada/excluída na lista de tokens do console; ③ se o crédito da conta se esgotou; ④ se o cabeçalho Authorization está no formato Bearer sk-... (atenção ao espaço depois de Bearer).

Erro 429, muitas requisições?

O gateway aplica limite de taxa por token. Reduza a concorrência, alongue os back-offs de nova tentativa (back-off exponencial + jitter recomendados) ou suba o limite do token no console.

A saída em streaming se interrompe no meio?

Para respostas longas, ative a retentativa por timeout do SDK; se passar por proxy corporativo, confirme que ele não armazena em buffer o fluxo SSE (text/event-stream).

Quais modelos são suportados?

A referência é a lista em tempo real da página «Modelos» do console. O 4-4 AI agrega GLM, DeepSeek, Qwen e mais modelos de ponta — mesma chave, mesma interface, e você troca de modelo.

Artigos relacionados

one-api / new-api auto-hospedado vs gateway de IA gerenciado: custo, operação e segurança Um arcabouço honesto de decisão para equidades em dúvida entre «construir ou comprar»: custos ocultos de opera Conecte Cursor / Claude Code / Cherry Studio a um gateway de IA personalizado Configuração de Base URL personalizada para as principais ferramentas de código e chat de IA, com guia rápido
Pronto para conectar?

Uma chave para GLM, DeepSeek, Qwen e mais modelos de ponta: faturamento unificado e uso visualizado.

Ver modelos e preços Testar grátis