Usa la API de Dropstone con tu plan

La API de Dropstone es un endpoint compatible con OpenAI para código que no debe depender de una superficie con sesión iniciada: un trabajo de CI, una función serverless, un servicio en otro lenguaje. Crea una clave, apunta un cliente a Dropstone y estarás llamando a los mismos tres modelos que Chat y la CLI.

La referencia del endpoint está en docs.dropstone.io/cli/api. Esta página cubre claves, facturación y qué esperar.

Crear una clave de API

1. 1
   Abre Configuración en tu panel de control.
2. 2
   En Claves de API, elige Crear clave y asígnale un nombre.
3. Copia la clave. Tiene este formato dsk_live_... y solo se muestra una vez.

Trata la clave como una contraseña: nunca la confirmes en un repositorio y nunca la incluyas en un paquete de navegador. Cualquiera que la tenga puede gastar el saldo asociado. Puedes ver cuándo se usó cada clave por última vez y revocar cualquiera de ellas desde la misma página.

Facturación: pago por uso

El beneficio semanal pertenece a las superficies con sesión iniciada: Chat, la CLI y una sesión local del SDK. La API se mide por separado, por lo que el tráfico de un pipeline nunca consume el beneficio en el que trabajas, y una semana ocupada en Chat nunca detiene el pipeline. Recarga desde Facturación en el panel de control.

Una clave cuyo saldo está vacío se rechaza con un error que lo indica y un enlace para recargar, en lugar de servirse y cobrarse más tarde. No hay nivel gratuito en la API.

Compatible con OpenAI

El endpoint sigue el formato de finalizaciones de chat de OpenAI, por lo que la mayoría de los clientes existentes funcionan cambiando la URL base y la clave:

import OpenAI from "openai"

const openai = new OpenAI({
  baseURL: "https://api.dropstone.io/api/v1",
  apiKey: process.env.DROPSTONE_API_KEY,
})

Los modelos son dropstone-fast, dropstone-pro y dropstone-heavy; consulta ¿Qué modelos de IA usa Dropstone?. Nombrar un nivel sin versión ejecuta la alineación actual, por lo que un script sigue la alineación hacia adelante por sí solo. Para mantener una versión en su lugar, usa la forma con versión, por ejemplo dropstone-fast-1.7. Versiones de modelos y la alineación mensual cubre ambas. Las solicitudes funcionan desde cualquier lenguaje que pueda hacer una llamada HTTP.

Lo que la API no incluye

El endpoint no tiene estado, y deliberadamente es así:

• Sin memoria. No lee la memoria de tu cuenta, y nada de lo que responde se registra allí. La misma entrada da la misma respuesta, sin importar lo que le enseñaste a Dropstone la semana pasada.
• Sin herramientas y sin bucle de agente. Responde una finalización de chat. Leer un código base, editar archivos y ejecutar comandos pertenecen al SDK cliente local y a la CLI.

Si quieres que tu código use el agente y su memoria, usa el cliente local del SDK. Consulta Una memoria en cada superficie.

Límites de velocidad

Las solicitudes tienen límites de velocidad por IP, muy por encima del uso ordinario, para proteger el servicio. Una ráfaga que supere el límite se rechaza, así que retrocede y reintenta en lugar de apretar el bucle.

Dónde van las solicitudes

Las solicitudes de API se procesan en los Estados Unidos, igual que todas las demás superficies. Consulta Dónde se ejecutan tus solicitudes.

Organizaciones

Los miembros de una organización crean claves bajo su propia cuenta, y el saldo detrás de una clave pertenece al propietario de la clave. Los administradores de la organización pueden ver el uso de API por miembro en el panel de control de la organización, y una clave deja de funcionar cuando la cuenta detrás de ella se desactiva, que es lo que sucede cuando un miembro se elimina mediante SCIM.