Descripción general

Upsky AI te permite usar modelos de los principales laboratorios con la clave de API de Upsky de tu equipo, la misma que usan todos los productos de Upsky. Usa la API de OpenAI, así que funciona con cualquier cliente o SDK de OpenAI con solo cambiar su URL base. Los modelos de texto usan Chat Completions, y también hay modelos de imagen y de voz.

ConectaCopiar enlace

Apunta tu cliente a https://api.upsky.dev/v1/ai y usa tu clave de API:

import OpenAI from "openai"

const ai = new OpenAI({
  apiKey: process.env.UPSKY_API_KEY,
  baseURL: "https://api.upsky.dev/v1/ai",
})

const reply = await ai.chat.completions.create({
  model: "anthropic/claude-sonnet-5",
  messages: [{ role: "user", content: "Hola" }],
})

console.log(reply.choices[0].message.content)

O con cURL:

curl https://api.upsky.dev/v1/ai/chat/completions \
  -H "Authorization: Bearer $UPSKY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "messages": [{ "role": "user", "content": "Hola" }]
  }'

Elige un modeloCopiar enlace

Obtén la lista actual en el endpoint de modelos. Los ID de los modelos siempre incluyen al proveedor, con el formato provider/model-name. Cada modelo indica su type, que es text, image o speech, y su precio: por millón de tokens para texto, por imagen para imágenes y por millón de caracteres para voz. Agrega ?type=text para listar un solo tipo.

StreamingCopiar enlace

Usa "stream": true para recibir la respuesta como eventos enviados por el servidor mientras se escribe. El último evento antes de data: [DONE] indica los tokens usados y lo que costó la solicitud.

Claves de pruebaCopiar enlace

Una clave de prueba recibe una respuesta de ejemplo con el mismo formato que una real, con streaming o sin él, para que puedas construir y probar tu integración de principio a fin. Nunca llama a un modelo y nunca se cobra. El modelo que indiques igual tiene que existir.

Cuánto cuestaCopiar enlace

Cada solicitud se paga con los créditos de tu equipo, al precio de la lista de modelos. Las claves en vivo necesitan un plan Pro activo.

• Antes de que empiece una solicitud, Upsky aparta lo máximo que podría costar: la instrucción más la respuesta más larga permitida. Solo se cobra lo que la solicitud usó de verdad.
• Usa max_completion_tokens para limitar una respuesta. Sin este campo, un equipo sin recarga automática recibe un límite menor que sus créditos cubran, en lugar de un rechazo.
• Si tus créditos no cubren una solicitud y la recarga automática no puede añadir más, recibes 402 con insufficient_credits.
• Si cierras un stream antes de tiempo, se cobra lo que el modelo escribió hasta ese momento.
• usage.cost en cada respuesta indica lo que se cobró, en dólares estadounidenses.

LímitesCopiar enlace

• Una opción por solicitud: n debe ser 1.
• Solo herramientas de tipo función. Las herramientas integradas, como la búsqueda web de un proveedor, se rechazan.
• Solo el nivel de servicio predeterminado, sin nivel prioritario ni modo rápido.
• Cuerpos de solicitud de hasta 4 MB, con imágenes y archivos incluidos.
• Idempotency-Key se ignora: cada solicitud vuelve a preguntar al modelo.
• user se descarta. Para distinguir a tus propios usuarios, envía safety_identifier.

Los errores usan el mismo formato que el resto de la API. Consulta errores.

UsoCopiar enlace

La página AI del panel muestra lo que gastó tu equipo este mes, día por día, los modelos que más usa y sus solicitudes más recientes, de texto, imagen y voz.