Inicio rápido

Esta guía le acompaña en su primera llamada a LLM API: active el servicio, añada cuota, cree una clave y envíe solicitudes con curl, Python y Node.js.

#Datos de conexión

El panel Información de la API de la página API de LLM → Resumen de la cuenta enumera los endpoints habituales, cada uno con un botón para copiarlo:

#Paso 1: Activar el servicio

1. Inicie sesión en la consola y abra API de LLM → Resumen de la cuenta (/llm/account).
2. En su primera visita, la página indica que el servicio no está activado. Haga clic en Activar ahora.
3. Una vez activado, la página muestra los datos de su cuenta, las estadísticas de uso, los gráficos y la información de la API.

#Paso 2: Añadir cuota

Las llamadas a los modelos consumen la cuota de su cuenta de LLM. Puede añadir cuota de dos formas:

• Transferir desde el saldo de su cuenta principal: en la tarjeta Saldo actual de Resumen de la cuenta, haga clic en Transferir, introduzca un importe y haga clic en Confirmar transferencia. La transferencia mínima es de 1 y el cuadro de diálogo muestra cuánta cuota obtendrá.
• Código de canje: si tiene un código, introdúzcalo en la tarjeta Recargar con código de canje y haga clic en Canjear.

Para recargar primero su saldo principal, haga clic en Recargar saldo en la tarjeta Saldo actual. Se abre Facturación → Saldo (/billing/balance).

#Paso 3: Crear una clave de API

1. Abra API de LLM → Tokens de API (/llm/tokens).
2. Haga clic en Crear clave en la esquina superior derecha.
3. Introduzca un Nombre. Es obligatorio. Puede dejar el resto de las opciones con los valores predeterminados: grupo predeterminado, sin límites de modelos, sin límites de IP y sin caducidad. Consulte Claves de API, cuota y uso para saber qué hace cada opción.
4. Haga clic en Crear. Cuando se abra el cuadro de diálogo «Nueva clave creada», copie la clave completa que comienza con sk-.

#Paso 4: Elegir un modelo

Consulte los nombres de los modelos y sus precios en API de LLM → Modelos y precios (/llm/models), o consulte la API:

curl https://llm.yeap.cloud/v1/models \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY"

Los ejemplos siguientes utilizan gpt-4o-mini. La disponibilidad de un modelo depende del grupo de su clave y de la oferta actual de la plataforma. Consulte la página Modelos y sustituya el nombre del modelo por el que desee.

#Paso 5: Enviar una solicitud

#curl

curl https://llm.yeap.cloud/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Introduce yourself in one sentence."}
    ]
  }'

Para recibir la respuesta en streaming, añada "stream": true al cuerpo de la solicitud. La respuesta llegará en fragmentos mediante Server-Sent Events (SSE).

#Python (SDK de openai)

Instale primero el SDK: pip install openai.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["YEAP_LLM_API_KEY"],
    base_url="https://llm.yeap.cloud/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Introduce yourself in one sentence."}],
)
print(resp.choices[0].message.content)

# Streaming
stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Write a four-line poem."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

#Node.js (SDK de openai)

Instale primero el SDK: npm install openai.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.YEAP_LLM_API_KEY,
  baseURL: "https://llm.yeap.cloud/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "Introduce yourself in one sentence." }],
});
console.log(resp.choices[0].message.content);

#Ejemplo de embeddings

curl https://llm.yeap.cloud/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY" \
  -d '{"model": "text-embedding-3-small", "input": "Yeap Cloud"}'

#Paso 6: Consultar el uso

Cuando finalice una llamada, abra API de LLM → Registro de solicitudes para consultar el modelo, los recuentos de tokens de entrada y salida y el costo. Consulte Claves de API, cuota y uso para obtener más información.

#Solución de problemas

• 401 con el mensaje «no token provided»: compruebe que el encabezado sea exactamente Authorization: Bearer sk-..., con un espacio después de Bearer.
• Cuota insuficiente: se ha agotado la cuota de su cuenta o el límite de cuota de la clave. Para la cuenta, transfiera o canjee más cuota. Para la clave, aumente su límite o active la cuota ilimitada en Claves de API.
• Modelo no disponible: el modelo no está en el grupo de su clave o los límites de modelos de la clave lo excluyen. Consulte la página Modelos o cambie a otro grupo o modelo.
• Solicitud rechazada y la clave tiene un límite de IP: asegúrese de que la IP de salida de su servidor figure en la lista de permitidas.
• Clientes de terceros: elija el tipo de proveedor «Compatible con OpenAI», establezca la dirección en https://llm.yeap.cloud/v1 y pegue su clave sk-.... Algunos clientes solo esperan https://llm.yeap.cloud y añaden /v1 automáticamente.