ES ▾
Obtener clave de API

API estilo OpenAI con cURL y un token Bearer

Para llamar a una API estilo OpenAI desde la línea de comandos envías una petición HTTP POST con un encabezado Authorization que lleva tu token. Esta página proporciona comandos cURL funcionales para cada característica de esta API y las comprobaciones que realizar cuando falle una.

Actualizado

Ventana de terminal enviando una clave dorada y paquetes de datos a través de una cinta de luz a un servidor

Puntos clave

  • El token se incluye en el encabezado Authorization: Bearer YOUR_KEY, y el ID del modelo es uncensored.
  • Existen dos endpoints: GET /v1/models y POST /v1/chat/completions.
  • Añade -N y stream true para ver cómo llegan los tokens mediante eventos enviados por el servidor.
  • Lee X-Balance-USD y los encabezados de límite de peticiones con curl -i; un 429 significa esperar y reintentar.

La petición mínima

Aquí está la forma más corta de hacer open ai api curl con token contra este servicio. Pon la clave en una variable de entorno para que no termine en el historial de tu shell, luego envía un mensaje 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."}
    ]
  }'

La respuesta es JSON con la estructura de chat completion de OpenAI. La respuesta se encuentra en choices[0].message.content, y un objeto usage informa de los tokens de prompt y de completado. Cada parte del comando tiene una función:

  • Authorization: Bearer ... lleva el token. "Bearer" es el nombre del esquema; quien tenga el token se trata como su propietario, por eso lo mantienes fuera de repositorios públicos.
  • Content-Type: application/json le dice al servidor cómo leer el cuerpo. Sin él, la petición suele fallar con un error de análisis del cuerpo.
  • model debe ser uncensored, el único modelo que sirve esta API.
  • messages es una lista de objetos con un role (system, user, assistant o tool) y content.

Para obtener una clave, regístrate con Google o correo electrónico y contraseña, luego usa la página de claves de API. Los nuevos usuarios pueden reclamar $0.50 de crédito de prueba con un clic allí: sin tarjeta, válido por 7 días, uno por persona.

Comprueba la clave con GET /v1/models

Antes de depurar una petición larga, confirma que el token funciona con la llamada más barata disponible. Listar modelos no cuesta nada y muestra si la URL, el encabezado y la clave son correctos.

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY"

Una buena respuesta es una lista JSON que incluye uncensored. Si tienes jq instalado, canaliza la salida para extraer solo los IDs:

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'

Si no devuelve nada útil, recorre la lista siguiente en orden, porque las causas están listadas por frecuencia:

  1. La variable está vacía. Ejecuta echo "${UF_KEY:0:6}" para ver los primeros caracteres sin imprimir toda la clave.
  2. El encabezado está mal escrito, o falta "Bearer" antes de la clave.
  3. Comillas curvas de un documento o cliente de chat reemplazaron comillas rectas en el comando.
  4. La URL base es incorrecta. Es https://api.unfilteredaimodels.com/v1, con api. al principio y /v1 al final.
  5. La clave se copió con un espacio o salto de línea al final.

Lee los encabezados de respuesta

Añade -i para incluir encabezados en la salida, o -D - para imprimirlos manteniendo el cuerpo limpio:

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"}]}'

Cuatro encabezados de respuesta vale la pena conocer:

CabeceraSignificado
X-Request-IdIdentificador de esta petición. Cítalo si contactas con soporte.
X-Balance-USDTu crédito prepago restante.
X-RateLimit-Limit-RequestsPeticiones por minuto permitidas para tu clave.
X-RateLimit-Limit-ConcurrencyPeticiones simultáneas permitidas para tu clave.

Los límites son 300 peticiones por minuto y 8 peticiones concurrentes para una clave completa, y 60 por minuto y 2 concurrentes para una clave de prueba. La petición anterior establece max_tokens en 5 solo para mantener la prueba pequeña. En uso normal max_tokens es opcional, y la finalización puede usar lo que quede de la ventana de 100.000 tokens tras tu prompt.

Streaming desde la línea de comandos

Establece "stream": true y añade -N para que curl no almacene en búfer la salida. Verás líneas que comienzan con data:, cada una llevando un pequeño delta JSON, y un data: [DONE] final. El fragmento anterior incluye el 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 solo el texto, filtra el streaming con una tubería corta:

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

Una petición en streaming mantiene su espacio de concurrencia hasta que termina el streaming. Si inicias muchos streaming en paralelo desde un script y olvidas dejarlos terminar, alcanzarás el límite de concurrencia aunque la tasa de peticiones sea baja.

Modo JSON y llamadas a funciones

El modo JSON hace que el modelo devuelva un único objeto JSON válido. Indica la forma que quieres en el prompt, o las claves serán lo que el modelo elija.

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'

Las llamadas a funciones usan los campos estándar tools y tool_choice. El modelo responde con un array tool_calls en lugar de texto; ejecutas la función tú mismo y envías el resultado de vuelta como un mensaje con role: "tool" y el tool_call_id correspondiente.

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?"}]
  }'

En la respuesta, busca choices[0].message.tool_calls[0].function.arguments. Es una cadena JSON que analizas, llamas a tu propia función del clima con ella, y devuelves en la siguiente petición. Parámetros como temperature, top_p, stop, seed y las penalizaciones se pasan a través. La documentación lista todos los campos admitidos.

Mantén el token seguro y los comandos ordenados

Un token Bearer es una contraseña con otro nombre. Cualquiera que lo tenga puede gastar tu crédito, así que trátalo con el mismo cuidado. Nunca pegues una clave real en un issue público, una captura de pantalla o un registro de terminal compartido. Si sospechas que una clave se filtró, reemplázala desde la página de claves y actualiza tus scripts.

El historial de shell es la fuga más común en una máquina personal. Escribir la clave directamente en un comando la almacena en el archivo de historial. Establecerla una vez con export aún guarda esa línea. Dos hábitos más limpios ayudan. Lee la clave de un archivo que solo tú puedas abrir, o prefixa el comando con un espacio si tu shell está configurado para ignorar líneas que empiecen con espacio. Un archivo pequeño funciona bien:

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)"

Los cuerpos JSON largos son difíciles de leer dentro de comillas simples, y el quoting falla en cuanto el prompt contiene un apóstrofe. Pon el cuerpo en un archivo y deja que curl lo lea con -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'

El mismo enfoque mantiene manejables los prompts grandes dentro del límite de cuerpo de 8 MB, y un archivo puede versionarse en git mientras la clave permanece fuera del repositorio. En PowerShell de Windows, las comillas simples alrededor del JSON se comportan de forma distinta y no existe la continuación de línea con barra invertida; la forma -d @request.json evita ambos problemas, y puedes usar un acento grave al final de una línea para continuar un comando.

Cuando termines de probar, pasa a un SDK. Las bibliotecas de OpenAI para Python y Node aceptan la misma URL base y clave, manejan reintentos y streaming por ti, y leen el mismo formato de respuesta que has estado analizando manualmente aquí. Los comandos cURL siguen siendo la forma más rápida de comprobar si un fallo proviene de tu código o de la petición misma, así que mantén uno conocido como bueno en tus notas. Cuando reportes un problema a soporte, incluye el X-Request-Id de la llamada fallida y el código de estado exacto; ese par permite a alguien encontrar la petición sin pedirte que repitas la prueba, y ahorra una ronda de idas y vueltas.

Errores, reintentos y coste por llamada

Cuando excedes un límite, la API responde HTTP 429. El código de error indica qué límite: rate_limited significa demasiadas peticiones por minuto, concurrency significa demasiadas a la vez. Una sobrecarga temporal también devuelve 429 y añade Retry-After: 5. Curl puede reintentar por sí solo errores transitorios:

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"}]}'

También mantén el cuerpo por debajo de 8 MB, lo cual importa si publicas archivos codificados en el prompt.

Las peticiones fallidas o rechazadas no se cobran. Las exitosas siguen una fórmula sencilla: $0,15 por cada 1M de tokens de entrada y $0,50 por cada 1M de tokens de salida. Una llamada de prueba con 40 tokens de entrada y 120 tokens de salida cuesta 40 / 1.000.000 x $0,15 = $0,000006 más 120 / 1.000.000 x $0,50 = $0,00006, es decir, $0,000066 en total. Mil de ellas suman $0,066.

El crédito es prepago y no caduca. Las recargas van desde $20 hasta $500 en cantidades enteras, con un bono del 5% desde $50, 10% desde $100 y 15% desde $200, con cripto (USDT en TRC20, USDC en Base). La página de precios muestra los detalles. Si una respuesta parece incorrecta, la página de mitos y datos reales explica qué hace y qué no hace el modelo.

Preguntas y respuestas

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.

¿Dónde va el token en un comando cURL?
    En un encabezado: -H "Authorization: Bearer YOUR_KEY". El cuerpo de la petición también necesita el encabezado Content-Type: application/json.
¿Qué nombre de modelo debo usar?
    Usa uncensored. Puedes confirmarlo con GET /v1/models.
¿Por qué obtengo 429?
    Has superado un límite. El código rate_limited significa demasiadas peticiones por minuto, concurrency significa demasiadas a la vez. Espera unos segundos o reduce el número de peticiones simultáneas.
¿Cómo veo mi crédito restante?
    Cada respuesta incluye un encabezado X-Balance-USD. Imprime los encabezados con curl -i o curl -D -.
¿Es esta la API oficial de OpenAI?
    No. Es un servicio independiente compatible con OpenAI que ejecuta un modelo de pesos abiertos, por lo que los SDK y los comandos cURL diseñados para el formato de OpenAI funcionan tras cambiar la URL base y la clave de API.