Início rápido com 4-4 AI: conecte-se a uma API de IA unificada em 5 minutos
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
- Acesse www.4-4.vip, crie uma conta e faça login no console;
- Recarregue saldo no console ou resgate um código de cartão;
- 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.
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:
| Item | Valor |
|---|---|
| Base URL | https://www.4-4.vip/v1 |
| API Key | A chave sk-... criada na página de tokens do console |
| Parâmetro model | Informe 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
- LangChain / LlamaIndex: use os componentes compatíveis com OpenAI e aponte
base_url/openai_api_basepara o endereço acima; - Cursor / Claude Code / Cherry Studio e outras ferramentas de IA: informe a Base URL e a chave nas configurações de «API personalizada / compatível com OpenAI»;
- Desenvolvimento próprio: qualquer cliente HTTP conforme ao protocolo OpenAI chama diretamente, sem SDK adicional.
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
Uma chave para GLM, DeepSeek, Qwen e mais modelos de ponta: faturamento unificado e uso visualizado.
Ver modelos e preços Testar grátis