ES ▾
Obtener clave de API
API sin censura compatible con OpenAI para desarrolladores.Actualizado

Ejemplos de curl para LLM API que puedes copiar y ejecutar

Si quieres probar la API LLM con curl antes de escribir código, las solicitudes de abajo son suficientes. Cada una apunta a un endpoint compatible con OpenAI, usa el ID de modelo uncensored y se ejecuta desde una terminal estándar.

Panel de terminal enviando un haz de luz a un cubo de servidor, representando una solicitud curl a una API LLM

Configura tu shell y verifica el endpoint

Obtén una clave desde la página de clave de API, luego expórtala junto con la URL base para no pegar secretos en cada comando.

export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"

Cada solicitud envía la clave como un token bearer en el encabezado Authorization. Los cuerpos de las solicitudes son JSON, así que añade Content-Type: application/json cuando hagas POST. El tamaño máximo del cuerpo es 8 MB, lo cual solo importa si pegas documentos muy grandes en el prompt.

Los ejemplos usan las comillas simples de un shell Unix. En PowerShell de Windows, pon el JSON en un archivo y pásalo con --data @body.json para evitar problemas de comillas.

La comprobación de sanidad más barata es una GET que liste los modelos. Confirma la clave y la URL, y no cuesta nada.

curl -s "$BASE/models" \
  -H "Authorization: Bearer $API_KEY"

El array data de la respuesta debería incluir el ID uncensored. Un 401 significa que falta la clave o está mal escrita. Si curl no puede conectarse en absoluto, verifica el host en $BASE y asegúrate de que termine en /v1 sin una ruta adicional.

1. Envía una completación de chat

Esta es la solicitud que envía cualquier cliente estilo OpenAI bajo el capó.

curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Give me three names for a fantasy tavern."}
    ],
    "temperature": 0.8,
    "max_tokens": 200
  }'

La respuesta es JSON. El texto está en choices[0].message.content, y los conteos de tokens están en usage. Canaliza la salida a través de jq -r '.choices[0].message.content' si tienes jq instalado y solo quieres el texto. El campo max_tokens es opcional; déjalo fuera y la completación puede usar lo que quede de la ventana de 100,000 tokens.

El endpoint más nuevo POST /v1/responses también está disponible si tu cliente usa ese formato. Para la lista completa de parámetros, consulta la documentación.

2. Transmite la respuesta

Añade "stream": true y dile a curl que no haga buffering con -N. Los tokens se imprimirán a medida que se generen.

curl -N "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Count from one to ten in words."}]
  }'

Cada línea comienza con data: y contiene un pequeño fragmento JSON con un delta. Los últimos eventos llevan el uso, y el streaming termina con data: [DONE]. Sin -N curl espera un buffer completo, y la salida parece llegar de una sola vez. Ten en cuenta que una solicitud en streaming mantiene una ranura de concurrencia ocupada hasta que termine.

3. Pide JSON

Para una salida que un script analizará, activa el modo JSON con response_format. Menciona la palabra JSON en el prompt para que el modelo sepa qué forma esperas.

curl -s "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [{"role": "user",
      "content": "Return JSON with keys name and level for a fantasy character."}]
  }' | jq -r '.choices[0].message.content | fromjson'

El filtro final fromjson analiza la cadena dentro de content, así que jq falla ruidosamente si el modelo devolvió algo que no es JSON válido. Eso lo convierte en una prueba rápida útil. Más patrones están en la página de modo JSON.

4. Prueba una llamada a herramienta

Las llamadas a herramientas permiten que el modelo le pida a tu código que ejecute una función. Describes la función en un array tools, y si el modelo decide usarla, la respuesta contiene una entrada tool_calls en lugar de texto.

curl -s "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "tool_choice": "auto"
  }' | jq '.choices[0].message.tool_calls'

Deberías obtener un nombre de función y una cadena JSON de argumentos. Tu código ejecuta la función, luego envía una segunda solicitud que repite los mensajes anteriores, añade el mensaje del asistente con la llamada a herramienta, y añade un mensaje con role: "tool" que contiene el resultado. El modelo luego escribe la respuesta final.

5. Verifica encabezados y saldo

Añade -i para ver los encabezados de respuesta junto con el cuerpo. Encontrarás X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests y X-RateLimit-Limit-Concurrency.

curl -s -i "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
  | grep -i "^x-"

curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"

La segunda llamada devuelve tu crédito directamente. Las herramientas compatibles con OpenAI pueden usar GET /v1/dashboard/billing/credit_grants en su lugar. Una petición mínima como la anterior cuesta una fracción de centavo: con 10 tokens de entrada y 5 de salida, el precio es 10 x 0,15 / 1.000.000 + 5 x 0,50 / 1.000.000 = $0,000004. Consulta la página de precios para ver las tarifas.

Un script de prueba de humo reutilizable

Una vez que confías en las llamadas individuales, envuélvelas en un script corto que puedas ejecutar después de cualquier despliegue, rotación de clave o cambio de red. Falla en el primer problema, así que ves exactamente qué paso falló.

set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"

echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'

echo "chat:"
curl -sf "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
  | jq -r '.choices[0].message.content'

echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"

La bandera -f hace que curl salga con un error en caso de fallos HTTP, y set -e detiene el script ahí. Inclúyelo en un trabajo cron o en un paso de integración continua si ejecutas un servicio sobre esta API y quieres una alerta temprana cuando algo cambie. Guarda la clave en un almacén de secretos o en una variable de entorno, nunca en el archivo del script.

Al variar la petición, prueba un ajuste a la vez: temperature para aleatoriedad, top_p para muestreo de núcleo, stop para secuencias de finalización personalizadas y seed para salida repetible. Todos se pasan al modelo, así que puedes comparar su efecto desde el mismo historial de terminal.

Lectura de errores de curl

EstadoCausa probableSolución
401Clave faltante o incorrectaVerifica el encabezado Authorization y que $API_KEY esté exportado
400JSON mal formado o campo incorrectoValida el cuerpo con jq . antes de enviar
429, código rate_limitedMás de 300 peticiones por minuto (60 en una clave de prueba)Ralentiza tu bucle
429, código concurrencyMás de 8 peticiones a la vez (2 en una clave de prueba)Ejecuta menos trabajos en paralelo
429 con Retry-After: 5Sobrecarga temporalEspera 5 segundos y reintenta

Añade -w "\n%{http_code}\n" para imprimir el código de estado después del cuerpo, lo que te ahorra adivinar. Los cuerpos de error son JSON con un mensaje y un código, así que jq .error los muestra limpiamente. Si ves un 429 en un bucle, no reintentes al instante; una pausa de unos segundos permite que se limpien la ventana por minuto y las ranuras concurrentes, y un bucle de reintento ajustado solo te mantiene por encima del límite. Una clave de prueba tiene límites más estrictos que una clave completa, así que un script que funciona después de tu primera recarga puede fallar con el crédito de prueba si ejecuta trabajos en paralelo. Una vez que las peticiones se comporten, pasa a un SDK; la misma URL y nombre de modelo se mantienen sin cambios. Las nuevas cuentas pueden reclamar $0.50 de crédito de prueba con un clic, suficiente para cientos de llamadas de prueba pequeñas. Las recargas posteriores comienzan en $20 y se pagan en cripto (USDT en TRC20 o USDC en Base).

Preguntas y respuestas

¿A qué URL envío las solicitudes curl?

Usa https://api.uncensoredllmapi.com/v1 como base, luego añade /chat/completions, /responses, /models o /balance según lo que necesites.

¿Cómo pruebo las llamadas a herramientas con curl?

Añade un array de herramientas con una definición de función al cuerpo de la solicitud de chat. Si el modelo decide llamarlo, la respuesta contiene tool_calls y envías el resultado de vuelta como un mensaje con role tool.

¿Por qué curl no muestra nada hasta que termina la respuesta?

Probablemente estés haciendo streaming sin la bandera -N. Añade -N para que curl imprima cada fragmento a medida que llega.

¿Una petición fallida cuesta dinero?

No. Las peticiones fallidas o rechazadas no se cobran.

Tu clave está a un paso de completar el formulario

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