ES ▾

Chinese LLM APITraducción

Obtener clave de API

Actualizado

URL de API compatible con OpenAI: URL base y encabezados

La URL base es https://api.chinesellmapi.com/v1. Ponla donde tu cliente de OpenAI espere una URL base, añade tu clave como token Bearer y usa el ID de modelo uncensored.

Un cable que conecta el terminal de un portátil con un cubo de servidor brillante, representando la conexión de un cliente a un endpoint de API

La respuesta corta

Si buscas una URL de API compatible con openai para este servicio, copia este valor:

https://api.chinesellmapi.com/v1

Esa es la URL base. Cada SDK de OpenAI, cliente de escritorio y framework de agentes que tenga un campo llamado "base URL", "API base", "endpoint" o "host" acepta esta cadena. La clave va en el campo "API key" correspondiente, y el nombre del modelo es uncensored.

Existen dos endpoints detrás: POST /v1/chat/completions para chat y GET /v1/models para listar modelos. No se ofrece nada más de la superficie de OpenAI, por lo que no hay ruta de embeddings, ni de imágenes, ni de fine-tuning. Si necesitas una clave primero, la página de clave de API te guía a través del registro.

URL base frente a URL de endpoint completo

La mayoría de los errores ocurren aquí. Los clientes se dividen en dos grupos: los que quieren la URL base y añaden la ruta ellos mismos, y los que quieren la URL completa de la llamada. La tabla muestra ambas formas.

Lo que pide el campoValor a ingresar
URL base, API base, host de OpenAIhttps://api.chinesellmapi.com/v1
URL completa de completions de chathttps://api.chinesellmapi.com/v1/chat/completions
URL de lista de modeloshttps://api.chinesellmapi.com/v1/models

Los SDK oficiales de OpenAI, el wrapper de OpenAI de LangChain, LiteLLM y la mayoría de las interfaces de chat pertenecen al primer grupo. Las herramientas que te permiten pegar una URL de petición cruda pertenecen al segundo. Cuando una etiqueta de campo no indica cuál es, lee el texto del marcador de posición: si muestra algo que termina en /v1, quiere la URL base.

Barras finales

La mayoría de los SDKs manejan una barra final, pero algunos construyen la ruta final mediante concatenación de cadenas simple. Si obtienes un 404 y la URL termina con /v1/, elimina la última barra y vuelve a intentarlo.

Encabezados que espera la API

Las peticiones necesitan un encabezado para la autenticación y otro para el tipo de cuerpo:

  • Authorization: Bearer YOUR_KEY
  • Content-Type: application/json

Los SDKs los configuran ambos por ti. Si construyes peticiones manualmente, aquí tienes la llamada mínima funcional:

curl https://api.chinesellmapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in one sentence."}]
  }'

La respuesta incluye algunos encabezados que vale la pena registrar: X-Request-Id para preguntas de soporte, X-Balance-USD para el crédito restante, y X-RateLimit-Limit-Requests y X-RateLimit-Limit-Concurrency para los límites aplicables a tu clave.

Configuración en los SDK de OpenAI

Solo dos valores cambian en comparación con una configuración de OpenAI estándar: la URL base y la clave. Todo lo demás en tu código permanece igual.

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.chinesellmapi.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Translate 'good morning' into Chinese."}],
)
print(resp.choices[0].message.content)

Node

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.chinesellmapi.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Translate 'good morning' into Chinese." }],
});
console.log(resp.choices[0].message.content);

El streaming funciona de la misma manera: añade stream: true y lee los fragmentos. Las cifras de uso llegan al final del stream. Ten en cuenta que una petición streaming ocupa una de tus ranuras de concurrencia hasta que el stream se cierre.

Variables de entorno en lugar de código

Los SDK actuales de OpenAI para Python y Node leen OPENAI_BASE_URL y OPENAI_API_KEY del entorno cuando no los pasas en el código. Esa es la forma más rápida de apuntar un proyecto existente a un nuevo endpoint sin tocar una línea:

export OPENAI_BASE_URL="https://api.chinesellmapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py

Muchas herramientas de terceros usan los mismos dos nombres de variable, aunque algunas usan los suyos propios, como API_BASE o OPENAI_API_BASE en proyectos antiguos. Consulta la documentación de la herramienta para el nombre exacto. Si un proyecto codifica api.openai.com en algún lugar, busca ese nombre de host en el código fuente y reemplázalo.

El nombre del modelo suele estar en una configuración separada, así que recuerda cambiarlo a uncensored también. Dejar un nombre de modelo de OpenAI por defecto es la segunda causa más común de error después de una URL incorrecta.

Verifica la conexión antes de depurar tu aplicación

Prueba la URL y la clave con una llamada que no cueste nada. Listar modelos no necesita tokens:

curl https://api.chinesellmapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

Si esto devuelve una lista JSON que incluye uncensored, la URL y la clave están bien y cualquier problema restante está en la configuración de tu cliente. Si falla, usa esta tabla.

SíntomaCausa probableSolución
404 No encontradoRuta duplicada (/v1/v1/...) o falta /v1Ingresa la URL base exactamente una vez, terminando en /v1
401 No autorizadoFalta la clave, se copió con un espacio o se envió en el encabezado incorrectoEnvía Authorization: Bearer YOUR_KEY y vuelve a copiar la clave
429 con código rate_limitedDemasiadas peticiones por minutoReduce la velocidad o pon las peticiones en cola
429 con código concurrencyDemasiadas peticiones al mismo momentoLimita las llamadas paralelas, recuerda que los streams ocupan una ranura
429 con Retry-After: 5Sobrecarga temporalEspera cinco segundos y reintenta
Modelo no encontradoUn nombre de modelo de OpenAI dejado por errorEstablece el modelo a uncensored

Límites que debes conocer antes de conectar producción

Una clave completa permite 8 peticiones simultáneas y 300 peticiones por minuto. La clave de prueba permite 2 peticiones simultáneas y 60 por minuto. El cuerpo de la petición puede tener hasta 8 MB, y la ventana de contexto es de 100,000 tokens, prompt y completion en conjunto, por lo que max_tokens es opcional.

El servicio es solo de texto y ejecuta un único modelo de pesos abiertos de un proveedor independiente. No es la API oficial de ningún proveedor de modelos y no enruta entre proveedores. Si tu aplicación es un producto en chino, la guía rápida para aplicaciones en chino muestra cómo estructurar los prompts, y la guía de API de traducción cubre glosarios y marcadores de posición.

La facturación es pago por uso con crédito prepago: $0.15 por 1M de tokens de entrada y $0.50 por 1M de tokens de salida. Las peticiones fallidas o rechazadas no se cobran. La página de precios muestra los montos de recarga y los bonos, y los nuevos usuarios pueden reclamar $0.50 de crédito de prueba con un solo clic en la página de claves, válido por 7 días y sin tarjeta. Para una guía más detallada de la configuración del cliente, consulta la documentación de inicio rápido.

El contenido que sexualiza a menores de edad nunca está permitido; aparte de eso, el modelo está ajustado para responder sin rechazos de contenido para uso adulto lícito.

Otros lugares donde va la URL

Los nombres de los frameworks varían para el campo, pero el valor es el mismo. Tres ejemplos comunes:

# LangChain
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
    base_url="https://api.chinesellmapi.com/v1",
    api_key="YOUR_KEY",
    model="uncensored",
)

# LiteLLM
import litellm
r = litellm.completion(
    model="openai/uncensored",
    api_base="https://api.chinesellmapi.com/v1",
    api_key="YOUR_KEY",
    messages=[{"role": "user", "content": "ping"}],
)

En LiteLLM, el prefijo openai/ indica a la biblioteca que use el formato wire de OpenAI con tu propia URL base, y la parte después de la barra es el ID del modelo. Interfaces de chat como SillyTavern tienen una fuente "compatible con OpenAI personalizada" con tres campos: URL, clave y modelo. De nuevo, los mismos tres valores.

Mantén la clave fuera del navegador

No llames a la API desde JavaScript del front-end que se envía a los visitantes. Cualquiera puede leer la clave desde la página y gastar tu crédito. Coloca una pequeña ruta de servidor en el medio, guarda la clave en una variable de entorno allí, y deja que tu sitio llame a esa ruta.

Cambio entre endpoints sin cambios de código

Si pruebas varios proveedores, pon los tres valores en la configuración en lugar del código fuente. Un pequeño bloque de configuración hace el trabajo y convierte la URL en la única cosa que editas:

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.getenv("LLM_BASE_URL", "https://api.chinesellmapi.com/v1"),
    api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.getenv("LLM_MODEL", "uncensored")

Esto también facilita separar staging y producción: usa una clave diferente por entorno, y el encabezado de respuesta X-Balance-USD mostrará el crédito restante de cada uno.

Preguntas y respuestas

¿Incluyo /chat/completions en la URL base?

No. Ingresa https://api.chinesellmapi.com/v1 y deja que el SDK añada /chat/completions. Solo las herramientas que solicitan una URL de solicitud completa necesitan la forma más larga.

¿Puedo usar la misma URL para varias aplicaciones?

Sí. La URL y la clave pueden ir en cualquier número de clientes. Comparten los límites de tu clave: 8 peticiones simultáneas y 300 peticiones por minuto en una clave completa.

¿Qué nombre de modelo ingreso?

Usa uncensored. Puedes confirmarlo llamando a GET /v1/models con tu clave.

¿Es esta la API oficial de un proveedor estilo OpenAI?

No. Es una API alojada para un modelo de pesos abiertos ejecutado por un proveedor independiente, diseñada para ser compatible con el formato de solicitud de OpenAI.

¿Cómo pruebo la clave sin gastar crédito?

Llama a GET /v1/models con el encabezado Authorization. Devuelve la lista de modelos y no usa tokens.

Tu clave está a un formulario de distancia

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

Obtener clave de API