API estilo OpenAI com cURL e token Bearer
Para chamar uma API estilo OpenAI a partir da linha de comando, você envia um POST HTTP com um cabeçalho Authorization que contém seu token. Esta página fornece comandos cURL funcionais para cada recurso desta API e as verificações a executar quando falhar.
Atualizado

Pontos principais
- O token vai no cabeçalho Authorization: Bearer SUA_CHAVE, e o ID do modelo é uncensored.
- Existem dois endpoints: GET /v1/models e POST /v1/chat/completions.
- Adicione -N e stream true para ver os tokens chegarem via eventos enviados pelo servidor.
- Leia X-Balance-USD e os cabeçalhos de limite de taxa com curl -i; a 429 significa esperar e tentar novamente.
A requisição mínima
Aqui está a maneira mais curta de fazer open ai api curl com token contra este serviço. Coloque a chave em uma variável de ambiente para que ela não acabe no histórico do seu shell, depois envie uma mensagem de chat:
export UF_KEY="paste-your-key-here"
curl https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what a bearer token is in two sentences."}
]
}'
A resposta é JSON no formato de conclusão de chat da OpenAI. A resposta está em choices[0].message.content, e um objeto usage relata tokens de prompt e conclusão. Cada parte do comando tem uma função:
Authorization: Bearer ...carrega o token. "Bearer" é o nome do esquema; quem detém o token é tratado como seu proprietário, por isso você deve mantê-lo fora de repositórios públicos.Content-Type: application/jsoninforma ao servidor como ler o corpo. Sem isso, a requisição frequentemente falha com um erro de análise do corpo.modeldeve seruncensored, o único modelo que esta API oferece.messagesé uma lista de objetos com umrole(system, user, assistant ou tool) econtent.
Para obter uma chave, cadastre-se com Google ou e-mail e senha, depois use a página de chave de API. Novos usuários podem reivindicar $0,50 de crédito de teste grátis com um clique lá: sem cartão, válido por 7 dias, um por pessoa.
Verifique a chave com GET /v1/models
Antes de depurar uma solicitação longa, confirme se o token funciona com a chamada mais barata disponível. Listar modelos não custa nada e mostra se a URL, o cabeçalho e a chave estão corretos.
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY"
Uma boa resposta é uma lista JSON que inclui uncensored. Se você tiver jq instalado, encaminhe a saída para extrair apenas os IDs:
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'
Se nada útil for retornado, percorra a lista abaixo em ordem, porque as causas estão listadas pela frequência com que ocorrem:
- A variável está vazia. Execute
echo "${UF_KEY:0:6}"para ver os primeiros caracteres sem imprimir a chave inteira. - O cabeçalho está grafado incorretamente ou "Bearer" está faltando antes da chave.
- Aspas curvas de um documento ou cliente de chat substituíram as aspas retas no comando.
- A URL base está errada. É
https://api.unfilteredaimodels.com/v1, comapi.na frente e/v1no final. - A chave foi copiada com um espaço ou nova linha no final.
Leia os cabeçalhos de resposta
Adicione -i para incluir cabeçalhos na saída, ou -D - para imprimi-los mantendo o corpo limpo:
curl -s -D - -o /dev/null \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'
Quatro cabeçalhos de resposta valem a pena conhecer:
| Cabeçalho | Significado |
|---|---|
X-Request-Id | Identificador desta solicitação. Cite-o se entrar em contato com o suporte. |
X-Balance-USD | Seu crédito pré-pago restante. |
X-RateLimit-Limit-Requests | Requisições por minuto permitidas para sua chave. |
X-RateLimit-Limit-Concurrency | Requisições simultâneas permitidas para sua chave. |
Os limites são 300 requisições por minuto e 8 requisições simultâneas para uma chave completa, e 60 por minuto e 2 simultâneas para uma chave de teste. A requisição acima define max_tokens para 5 apenas para manter o teste pequeno. No uso normal, max_tokens é opcional, e a conclusão pode usar o que restar da janela de 100.000 tokens após o seu prompt.
Streaming da linha de comando
Defina "stream": true e adicione -N para que o curl não faça buffer na saída. Você verá linhas que começam com data:, cada uma carregando um pequeno delta JSON, e uma final data: [DONE]. O chunk anterior inclui uso de tokens.
curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
}'
Para imprimir apenas o texto, filtre o stream com um pipeline curto:
curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
| sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
| jq -rj '.choices[0].delta.content // empty'
echo
Uma solicitação em streaming mantém sua slot de concorrência até o fim do stream. Se você iniciar muitos streams em paralelo de um script e esquecer de deixá-los terminar, atingirá o limite de concorrência mesmo que a taxa de solicitação seja baixa.
Modo JSON e chamadas de ferramentas
O modo JSON faz o modelo retornar um único objeto JSON válido. Declare a forma desejada no prompt também, ou as chaves serão o que o modelo escolher.
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
]
}' | jq -r '.choices[0].message.content'
A chamada de funções usa os campos padrão tools e tool_choice. O modelo responde com uma matriz tool_calls em vez de texto; você executa a função e envia o resultado de volta como uma mensagem com role: "tool" e o tool_call_id correspondente.
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"tool_choice": "auto",
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
}'
Na resposta, procure por choices[0].message.tool_calls[0].function.arguments. É uma string JSON que você analisa, chama sua própria função de clima com ela e retorna na próxima solicitação. Parâmetros como temperature, top_p, stop, seed e as penalidades são passados. A documentação lista todos os campos suportados.
Mantenha o token seguro e os comandos organizados
Um token bearer é uma senha com um nome diferente. Qualquer um que o tenha pode gastar seu crédito, então trate-o com o mesmo cuidado. Nunca cole uma chave real em uma issue pública, uma captura de tela ou um log de terminal compartilhado. Se você suspeitar que uma chave vazou, substitua-a na página de chaves e atualize seus scripts.
O histórico do shell é o vazamento mais comum em uma máquina pessoal. Digitar a chave diretamente em um comando a armazena no arquivo de histórico. Definir uma vez com export ainda armazena essa linha. Dois hábitos mais limpos ajudam. Leia a chave de um arquivo que apenas você pode abrir, ou prefixe o comando com um espaço se o seu shell estiver configurado para ignorar linhas que começam com espaço. Um arquivo pequeno funciona bem:
mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key
export UF_KEY="$(cat ~/.config/uf/key)"
Corpos JSON longos são difíceis de ler dentro de aspas simples, e as aspas falham assim que o próprio prompt contém um apóstrofo. Coloque o corpo em um arquivo e deixe o curl lê-lo com -d @file:
cat > request.json <<'JSON'
{
"model": "uncensored",
"temperature": 0.3,
"messages": [
{"role": "system", "content": "You answer in plain language."},
{"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
]
}
JSON
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d @request.json | jq -r '.choices[0].message.content'
A mesma abordagem mantém prompts grandes sob o limite de corpo de 8 MB gerenciáveis, e um arquivo pode ser versionado no git enquanto a chave fica fora do repositório. No PowerShell do Windows, aspas simples ao redor do JSON se comportam de forma diferente e a continuação de linha com barra invertida não existe; a forma -d @request.json evita ambos os problemas, e você pode usar um acento grave no final de uma linha para continuar um comando.
Quando terminar os testes, passe para um SDK. As bibliotecas Python e Node.js da OpenAI aceitam a mesma URL base e chave, lidam com retentativas e streaming para você, e leem o mesmo formato de resposta que você tem analisado manualmente aqui. Os comandos cURL continuam sendo a maneira mais rápida de verificar se uma falha vem do seu código ou da própria solicitação, então mantenha um conhecido-bom em suas anotações. Quando relatar um problema ao suporte, inclua o X-Request-Id da chamada falha e o código de status exato; esse par permite que alguém encontre a solicitação sem pedir que você repita o teste, e economiza uma rodada de idas e vindas.
Erros, retentativas e custo por chamada
Quando você excede um limite, a API responde HTTP 429. O código de erro informa qual limite: rate_limited significa muitas requisições por minuto, concurrency significa muitas ao mesmo tempo. Uma sobrecarga temporária também retorna 429 e adiciona Retry-After: 5. O Curl pode tentar novamente por conta própria para erros transitórios:
curl --retry 3 --retry-delay 5 --retry-all-errors \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
Mantenha também o corpo abaixo de 8 MB, o que importa se você postar arquivos codificados no prompt.
Requisições falhas ou recusadas não são cobradas. As bem-sucedidas seguem uma fórmula simples: $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. Uma chamada de teste com 40 tokens de entrada e 120 de saída custa 40 / 1.000.000 x $0,15 = $0,000006 mais 120 / 1.000.000 x $0,50 = $0,00006, totalizando $0,000066. Mil deles totalizam $0,066.
O crédito é pré-pago e nunca expira. Recarregamentos variam de $20 a $500 em valores inteiros, com bônus de 5% a partir de $50, 10% a partir de $100 e 15% a partir de $200, por cripto (USDT na TRC20, USDC na Base). A página de preços mostra os detalhes. Se uma resposta parecer errada, a página de mitos e fatos explica o que o modelo faz e não faz.
Mais guias
Perguntas e respostas
Sua chave está a um formulário de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.
Onde fica o token em um comando cURL?
- No cabeçalho: -H "Authorization: Bearer SUA_CHAVE". O corpo da requisição também precisa do cabeçalho Content-Type: application/json.
Qual nome de modelo devo usar?
- Use uncensored. Você pode confirmar isso com GET /v1/models.
Por que recebo 429?
- Você atingiu um limite. O código rate_limited significa muitas requisições por minuto, concurrency significa muitas ao mesmo tempo. Aguarde alguns segundos ou reduza o número de chamadas simultâneas.
Como vejo meu crédito restante?
- Toda resposta inclui um cabeçalho X-Balance-USD. Imprima cabeçalhos com curl -i ou curl -D -.
Esta é a API oficial da OpenAI?
- Não. É um serviço independente compatível com OpenAI que executa um único modelo de pesos abertos, então SDKs e comandos cURL criados para o formato OpenAI funcionam após alterar a URL base e a chave.