Dropstone Support

Uso de la API con tu plan

Llama a Dropstone por HTTP con una clave de API. El endpoint es compatible con OpenAI, se factura por uso desde tu saldo de créditos y funciona desde cualquier lenguaje. Claves, errores, límites de velocidad y lo que la API no incluye.

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. Abre Configuración en tu panel de control.
  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

Las solicitudes con clave de API se facturan por uso desde tu saldo de créditos. Los beneficios del plan no se aplican a ellas.

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 recibe un rechazo con un error que lo indica y un enlace para recargar, en lugar de ser atendida y cobrada más tarde. No hay nivel gratuito en la API.

Compatible con OpenAI

El endpoint sigue el formato de chat completions 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 Elegir un modelo. Las solicitudes funcionan desde cualquier lenguaje que pueda hacer una llamada HTTP.

Lo que la API no incluye

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

  • 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 hayas enseñado a Dropstone la semana pasada.
  • Sin herramientas ni bucle de agente. Responde a un chat completion. Leer un código base, editar archivos y ejecutar comandos pertenecen al cliente local del SDK 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 normal, para proteger el servicio. Una ráfaga que supere el límite es rechazada, así que retrocede y reintenta en lugar de apretar el bucle.

Dónde van las solicitudes

Las solicitudes de API se procesan en Estados Unidos, igual que cualquier otra superficie. 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 la API por miembro en el panel de la organización, y una clave deja de funcionar cuando la cuenta detrás de ella se desactiva, que es lo que ocurre cuando un miembro se elimina mediante SCIM.

Related articles

Ctrl+I