PT ▾
Obter chave de API

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

Janela do terminal enviando uma chave dourada e pacotes de dados por uma fita de luz para um servidor

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/json informa ao servidor como ler o corpo. Sem isso, a requisição frequentemente falha com um erro de análise do corpo.
  • model deve ser uncensored, o único modelo que esta API oferece.
  • messages é uma lista de objetos com um role (system, user, assistant ou tool) e content.

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:

  1. A variável está vazia. Execute echo "${UF_KEY:0:6}" para ver os primeiros caracteres sem imprimir a chave inteira.
  2. O cabeçalho está grafado incorretamente ou "Bearer" está faltando antes da chave.
  3. Aspas curvas de um documento ou cliente de chat substituíram as aspas retas no comando.
  4. A URL base está errada. É https://api.unfilteredaimodels.com/v1, com api. na frente e /v1 no final.
  5. 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çalhoSignificado
X-Request-IdIdentificador desta solicitação. Cite-o se entrar em contato com o suporte.
X-Balance-USDSeu crédito pré-pago restante.
X-RateLimit-Limit-RequestsRequisições por minuto permitidas para sua chave.
X-RateLimit-Limit-ConcurrencyRequisiçõ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.

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.