1StopTek

Servicios para desarrolladores

Desarrolladores

Construye sobre el ecosistema 1StopTek.

Integra comunicación, IA e infraestructura de datos en tus aplicaciones a través de los servicios para desarrolladores de 1StopTek.

1st AI Platform API

En pruebas

Construye con la API de 1st AI Platform.

Una API HTTPS versionada para chat completions, streaming, salida estructurada y embeddings, servida por la plataforma que opera 1StopTek.

Pruebas restringidas

El acceso está limitado a testers invitados. El host de staging previsto aún no está en línea y no hay ningún modelo conectado: las solicitudes de inferencia devuelven 503 inference_unavailable. No se cobra nada.

Funcionalidades

Funcionalidades
FuncionalidadEstadoDetalles
Chat completionsEn pruebasPOST /api/v1/chat/completions con mensajes system, user y assistant; temperature, top_p, max_tokens y stop.
StreamingEn pruebasServer-sent events (stream: true): eventos chat.completion.chunk y, después, data: [DONE].
Salida estructuradaEn pruebasresponse_format json_object o json_schema; el resultado se valida contra tu esquema. No combinable con streaming.
EmbeddingsEn pruebasPOST /api/v1/embeddings, hasta 64 entradas de hasta 8000 caracteres cada una.
Descubrimiento de modelosEn pruebasGET /api/v1/models lista cada modelo con sus capacidades, su ventana de contexto y su límite de salida.
API de usoEn pruebasGET /api/v1/usage devuelve el recuento diario de tokens de un proyecto y los totales del mes en curso.
Recuperación de documentos (RAG)PrevistoImplementada en Eurylie con citas; todavía no expuesta en la API para desarrolladores.
Llamada a herramientas y funcionesPrevistoLas solicitudes que usan herramientas se rechazan con un error explícito, nunca se ignoran en silencio.
Entrada de imagen y audioNo compatibleSolo texto. El contenido que no es texto se rechaza con unsupported_content_type.

Los modelos y sus límites

La plataforma sirve modelos open-weight en su propio hardware de inferencia. GET /api/v1/models es la lista de referencia para cada entorno: cada entrada indica sus capacidades, su ventana de contexto y su número máximo de tokens de salida.

Ventana de contexto
Por modelo, según GET /api/v1/models. Configuración de staging prevista: 4096 tokens, prompt y salida en conjunto.
Salida máxima por solicitud
El menor entre el límite de tu tier (1024 en sandbox, 4096 en tiers superiores) y el límite propio del modelo (1024 en la configuración de staging prevista).
Mensajes por solicitud
hasta 256
Embeddings por solicitud
64 entradas de 8000 caracteres cada una

El rendimiento y la latencia aún no se han medido en el hardware de inferencia de producción. Publicaremos cifras medidas, no objetivos.

Safety Layer

Las entradas y salidas pasan por la Safety Layer de la plataforma. Una solicitud rechazada devuelve safety_error; una salida rechazada termina con finish_reason content_filter.

API y documentación

API y documentación

La API para desarrolladores usa HTTPS y JSON, con una descripción OpenAPI 3.1 generada a partir del mismo contrato con el que se prueba el servidor.

URL base

URL
Staging (pruebas)https://platform-api-staging.1stoptek.comHost previsto, aún no está en línea. Solo testers invitados; aún no hay ningún modelo conectado
Producciónhttps://api.1stoptek.comAún no abierto · solo claves live (1stai_live_…)

Autenticación

Envía la clave de API de tu proyecto como token bearer: Authorization: Bearer 1stai_test_…. Llama a la API solo desde tu servidor; nunca incluyas una clave en un navegador o una aplicación móvil.

Inicio rápido

Pruebas restringidas

Las pruebas son por invitación. Los testers aprobados inician sesión en la consola, indican su edad una vez (obligatorio en staging) y pueden crear organizaciones, proyectos y claves de prueba. Hasta que se conecte un modelo con cualificación de seguridad, las solicitudes de chat, streaming y embeddings devuelven 503 inference_unavailable, y no se cobra nada.
  1. Solicita acceso de tester (developers@1stoptek.com) y después crea una cuenta de 1StopTek y verifica tu dirección de correo.
  2. Abre la consola para desarrolladores y crea una organización; empieza con un proyecto Default.
  3. Crea una clave de API para el proyecto. Cópiala ahora: solo se muestra una vez.
  4. Expórtala como FIRSTAI_API_KEY y envía tu primera solicitud.
Shell
export FIRSTAI_BASE_URL=https://platform-api-staging.1stoptek.com
export FIRSTAI_API_KEY=1stai_test_...   # from the developer console
Chat completion · curl
curl -sS "$FIRSTAI_BASE_URL/api/v1/chat/completions" \
  -H "Authorization: Bearer $FIRSTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "system", "content": "You answer in one sentence."},
      {"role": "user", "content": "What is an API key?"}
    ],
    "max_tokens": 120
  }'
Streaming · curl
curl -sS -N "$FIRSTAI_BASE_URL/api/v1/chat/completions" \
  -H "Authorization: Bearer $FIRSTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Count from one to five."}],
    "max_tokens": 60,
    "stream": true
  }'
# data: {"object":"chat.completion.chunk","choices":[{"delta":{"content":"One"},...}]}
# ...
# data: [DONE]
Embeddings · curl
curl -sS "$FIRSTAI_BASE_URL/api/v1/embeddings" \
  -H "Authorization: Bearer $FIRSTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": ["first document", "second document"]}'
Salida estructurada · curl
curl -sS "$FIRSTAI_BASE_URL/api/v1/chat/completions" \
  -H "Authorization: Bearer $FIRSTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Extract: Berlin is the capital of Germany."}],
    "max_tokens": 120,
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "fact",
        "schema": {
          "type": "object",
          "properties": {"city": {"type": "string"}, "country": {"type": "string"}},
          "required": ["city", "country"]
        }
      }
    }
  }'
Python (biblioteca estándar)
import json, os, urllib.request

req = urllib.request.Request(
    os.environ["FIRSTAI_BASE_URL"] + "/api/v1/chat/completions",
    method="POST",
    headers={
        "Authorization": "Bearer " + os.environ["FIRSTAI_API_KEY"],
        "Content-Type": "application/json",
    },
    data=json.dumps({
        "messages": [{"role": "user", "content": "Say hello."}],
        "max_tokens": 60,
    }).encode(),
)
try:
    with urllib.request.urlopen(req, timeout=120) as resp:
        body = json.load(resp)
        print(body["choices"][0]["message"]["content"])
        print(body["usage"])
except urllib.error.HTTPError as err:
    error = json.load(err)["error"]
    print(err.code, error["type"], error["code"], error["request_id"])
JavaScript (Node.js 18+, sin dependencias)
const res = await fetch(`${process.env.FIRSTAI_BASE_URL}/api/v1/chat/completions`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FIRSTAI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    messages: [{ role: "user", content: "Say hello." }],
    max_tokens: 60,
  }),
});
const body = await res.json();
if (!res.ok) {
  const { type, code, request_id } = body.error;
  throw new Error(`${res.status} ${type}/${code} (request ${request_id})`);
}
console.log(body.choices[0].message.content, body.usage);

Todavía no existe un paquete SDK propio. Los ejemplos usan HTTP simple; como las estructuras de solicitud y respuesta siguen el formato chat-completions, ampliamente utilizado, muchas bibliotecas cliente existentes funcionan cambiando la URL base. Solo documentamos clientes que hemos probado.

Límites de solicitudes

Cada proyecto tiene una cuota de solicitudes por minuto y cada organización una cuota mensual de tokens, fijadas por su tier. Cada respuesta indica las solicitudes restantes en X-RateLimit-Limit-Requests y X-RateLimit-Remaining-Requests; una respuesta 429 incluye Retry-After.

TierSolicitudes por minuto (por proyecto)Tokens por mes (por organización)Tokens de salida máx.Streams simultáneos
sandbox20500.00010242
developer12010.000.000409610
scale600100.000.000409650
enterprise30001.000.000.0004096200

Las nuevas organizaciones empiezan en sandbox. Los tiers son límites, no precios; los tiers superiores se asignan tras una revisión.

Errores

Todos los errores tienen la misma estructura JSON. Ramifica tu lógica según type; registra request_id cuando contactes con soporte. Los mensajes nunca contienen tu prompt.

JSON
{"error": {"type": "rate_limit_error", "code": "rate_limited",
  "message": "project limit of 20 requests per minute reached",
  "param": null, "request_id": "req_…", "retry_after_seconds": 3}}
HTTPtypeCódigos habituales
400invalid_request_errorinvalid_messages, unsupported_parameter, context_length_exceeded
401authentication_errorinvalid_api_key
402quota_exceeded_errormonthly_quota_exceeded, spending_limit_reached
403permission_errorforbidden, organization_suspended
404not_found_errormodel_not_found
409conflict_errorkey_limit_reached, project_archived
422safety_errorsafety_refused
429rate_limit_errorrate_limited, too_many_streams
502 / 504model_errormodel_error, model_timeout, invalid_structured_output
503service_unavailable_errormodel_unavailable, billing_unavailable

Reintentos

Reintenta un 429 después de Retry-After, y los 502/503/504 con backoff exponencial. No reintentes sin cambios los errores de validación 4xx. Cada intento es una solicitud independiente y se mide por separado.

Versionado

La versión principal figura en la ruta (/api/v1) y en la cabecera X-API-Version. Dentro de v1 solo añadimos: nuevos endpoints, nuevos campos opcionales y nuevos valores de enumeración. Los clientes deben ignorar los campos desconocidos. Un cambio incompatible se publica como /api/v2, anunciado con antelación y con un periodo de retirada para v1.

Cuenta de desarrollador y claves de API

Cuenta de desarrollador y claves de API

Una sola cuenta de 1StopTek te permite iniciar sesión. Las organizaciones, los proyectos y las claves pertenecen a la plataforma; la consola los gestiona por ti.

Del registro a la primera solicitud

  1. 01

    Crear la cuenta

    Las pruebas son por invitación: solicita acceso de tester y después regístrate con correo y contraseña.

  2. 02

    Verificar el correo

    Sigue el enlace que te enviamos. Las cuentas no verificadas no pueden acceder a la consola.

  3. 03

    Crear la organización

    Te conviertes en su propietario. Con ella se crea un proyecto Default.

  4. 04

    Generar una clave de API

    Elige nombre, scopes y una caducidad opcional. La clave completa se muestra una sola vez.

  5. 05

    Enviar la primera solicitud

    Usa el inicio rápido con tu clave.

  6. 06

    Ver uso y costes

    Tokens, solicitudes y cargos estimados por proyecto y por clave.

Cómo se protegen las claves de API

  • Las claves tienen el formato 1stai_test_<id>_<secret>. Staging solo emite claves de prueba y producción solo claves live, y ninguna funciona en el otro entorno.
  • La clave completa se muestra exactamente una vez, al crearla o rotarla. Después, la consola solo muestra una breve pista.
  • La plataforma almacena un hash con clave (HMAC-SHA-256 con un secreto del lado del servidor), nunca la clave. Una copia de la base de datos por sí sola no sirve para autenticarse.
  • Las claves están asociadas a un único proyecto y solo llevan los scopes que elijas: models:read, chat:write, embeddings:write, usage:read.
  • La revocación surte efecto en la siguiente solicitud. La rotación emite una clave de reemplazo y mantiene operativa la antigua durante un periodo de gracia que tú eliges (hasta 7 días, o 0 para revocarla de inmediato).
  • Las organizaciones están aisladas entre sí: cada llamada a la consola y a la API se comprueba contra la organización a la que pertenece la clave o la cuenta.

Asistentes para sitios web

Asistentes para sitios web para desarrolladores

Los detalles técnicos detrás de la configuración guiada en la consola.

Solo un ejemplo: los asistentes para sitios web aún no están disponibles para clientes.

El código de instalación

El código identifica al asistente con su id público. No contiene ninguna clave. El asistente solo acepta solicitudes del navegador desde los orígenes https exactos de sitios cuya propiedad se confirmó. Un programa fuera del navegador puede imitar un origen, por eso también se aplican límites por visitante, por asistente y tu límite de gasto.

HTML
<script src="https://{widget-host}/widget/v1/agent.js" data-agent="agt_…" async></script>

El host del widget aún no está decidido; el código muestra un marcador.

Versión fija con Subresource Integrity

La ruta estable sigue las actualizaciones compatibles del widget. Para fijar una versión, usa la ruta con versión y el hash de integridad publicado en el manifest.json del widget.

HTML
<script src="https://{widget-host}/widget/v1/{version}/agent.js"
        integrity="sha384-…" crossorigin="anonymous"
        data-agent="agt_…" async></script>

Opciones

  • data-locale="de" establece el idioma.
  • Un elemento con id="1stai-agent" muestra el asistente integrado en lugar de flotante.
  • Con una Content Security Policy, permite el origen de la plataforma en script-src y connect-src, y los estilos en línea para el elemento de estilo propio del widget.

De servidor a servidor (ajustes avanzados)

Una clave agents:invoke está vinculada a los asistentes que elijas y no tiene ningún otro permiso. Guárdala en tu servidor; nunca en una página web.

Uso y facturación

Uso y facturación

La medición se realiza en el servidor, por solicitud, en el momento en que una solicitud se completa. La consola muestra exactamente lo que la plataforma ha registrado.

Qué se mide

  • Un registro por solicitud: organización, proyecto, id de clave, endpoint, modelo, estado, tokens de entrada y de salida, latencia. Sin contenido de prompts ni de salidas.
  • El recuento de tokens procede del servidor de modelos cuando este lo informa; en caso contrario se estima y se marca como estimado.
  • Reintentar con una nueva solicitud crea un nuevo registro. Repetir el mismo id de solicitud nunca se cuenta dos veces.

Qué ves en la consola

  • Tokens y solicitudes del mes en curso frente a tu cuota, por proyecto y por clave.
  • Cargos actuales estimados cuando se aplique una tarifa, con importe neto, IVA e importe bruto por separado.
  • Extractos mensuales de los meses cerrados. Aún no se emiten facturas; se emitirán cuando se abra el acceso de pago.

Alertas y límites de gasto

Umbral de alerta

Registra una alerta cuando el coste de uso del mes en curso (antes de la asignación incluida) supera el importe. Las solicitudes siguen funcionando.

Límite de gasto estricto

Las solicitudes que podrían llevar el coste de uso del mes en curso (antes de la asignación incluida) por encima del límite se rechazan con 402 spending_limit_reached antes de llamar al modelo.

Solicitudes en curso

Antes de llamar a un modelo, la plataforma reserva el coste máximo posible de la solicitud (entrada más tu max_tokens). Las solicitudes ya admitidas terminan con normalidad y su coste real nunca supera lo reservado, por lo que varias solicitudes simultáneas no pueden superar juntas un límite estricto. Una solicitud que podría superar el presupuesto restante se rechaza aunque su coste real hubiera sido menor.

Si no se puede comprobar el uso

Si la plataforma no puede leer el uso, las reservas o los límites, rechaza la solicitud con 503 billing_unavailable. Una consulta fallida nunca concede acceso ilimitado.

API v1 · contract 0b847d90d1

PulseChat Business API

Implementada, no activada

Mensajería empresarial para los sistemas que ya usas.

Las empresas verificadas podrán conectar su tienda, su sistema de tickets o su software de reservas a PulseChat: para responder a las conversaciones de soporte que inician sus clientes y para enviar mensajes transaccionales a los clientes que hayan dado su consentimiento.

La API Business está implementada y probada, pero aún no está activada y no tiene desarrolladores externos. La configuración, el entorno de pruebas y el acceso en producción no están abiertos; esta página lo indicará cuando cambie.

Dos usos admitidos

Respuestas a conversaciones de soporte

Un cliente inicia una conversación con tu empresa en PulseChat. Tu sistema puede leerla y responder. Tu empresa no puede iniciar estas conversaciones.

Mensajes transaccionales

Actualizaciones de pedidos, servicios, citas y cuentas, enviadas con plantillas aprobadas por PulseChat, solo a clientes que aceptaron recibir mensajes de tu empresa. Los clientes pueden retirar su consentimiento en cualquier momento. El modelo de consentimiento definitivo está en revisión legal.

Lo que existe y su estado

  • Respuestas a conversaciones iniciadas por clientesImplementada, no activada
  • Mensajes transaccionales a clientes que dieron su consentimientoImplementada, no activada
  • Plantillas revisadas por PulseChatImplementada, no activada
  • Entorno de pruebas con clientes sintéticosImplementada, no activada
  • Claves API de alcance limitado, con rotación y revocaciónImplementada, no activada
  • Webhooks firmadosImplementada, no activada
  • Consulta de eventos (polling)Implementada, no activada
  • Límites de usoImplementada, no activada
  • Acceso en producción tras la aprobación de PulseChatImplementada, no activada
  • Chat para sitios webPlanificada

Lo que la API no hace

  • Iniciar una conversación o escribir a clientes que ni escribieron primero ni dieron su consentimiento
  • Escribir a clientes que bloquearon a la empresa o retiraron su consentimiento
  • Enviar mensajes de marketing o masivos
  • Enviar códigos de acceso o de verificación

Cómo se identifica a los clientes

Tu sistema solo ve a un cliente mediante una referencia propia de tu empresa, no su número de teléfono, su ID de PulseChat ni su nombre. Eso no es anonimato: los clientes pueden seguir compartiendo datos personales en sus propios mensajes.

La configuración aún no está abierta

La configuración guiada y la documentación para desarrolladores se publicarán cuando PulseChat abra la API. Si quieres que te tengamos en cuenta para el piloto, escríbenos.

Pensada para flujos reales

Comercio electrónico

  1. Confirmación del pedido
  2. Actualización del envío
  3. Actualización de la entrega
  4. Respuesta a la pregunta del cliente

SaaS

Actualizaciones de cuenta y de servicio, y respuestas a las conversaciones de soporte que inician tus clientes.

Reservas

Confirmaciones, recordatorios, cambios y cancelaciones.

Marketplaces

Mensajes de pedidos y soporte entre un marketplace y sus propios clientes, sin compartir sus números de teléfono.

Cómo viaja un mensaje
  1. Tu servidor
  2. PulseChat Business API
  3. PulseChat
  4. Tu cliente

1Stop DataHub

Planificado

La capa de control para desarrolladores y empresas del ecosistema 1StopTek.

Un solo lugar para gestionar las integraciones 1StopTek de tu organización: aplicaciones, credenciales, equipos y uso.

Una cuenta. Varios productos. Una plataforma.

Los desarrolladores y las organizaciones gestionarán las integraciones 1StopTek compatibles desde un único entorno. Los cimientos subyacentes — identidad, roles y permisos, derechos de acceso, auditoría — están en desarrollo activo; DataHub es el producto planificado sobre ellos.

Qué gestionará

  • Aplicaciones
  • Credenciales de API
  • Webhooks
  • Equipos
  • Roles y permisos
  • Uso de la API
  • Analíticas
  • Suscripciones y facturación
  • Integraciones
  • Servicios 1StopTek compatibles
Una sola capa de control
Tu aplicación1Stop DataHubPulseChat · 1st AI Platform · futuras APIs de 1StopTek

Servicios para desarrolladores

¿Business o Desarrolladores?

1StopTek Developers

Para desarrolladores que integran tecnología 1StopTek en aplicaciones y servicios.

1Stop DataHub

La capa técnica de gestión planificada que conecta aplicaciones, credenciales, permisos, uso y servicios compatibles del ecosistema.

Construye con 1StopTek

El acceso de desarrolladores a la PulseChat Business API, la 1st AI Platform API y 1Stop DataHub está en preparación. Si eres desarrollador, empresa o socio de integración, habla con nosotros sobre acceso anticipado, integraciones de API, integraciones empresariales y colaboraciones.

developers@1stoptek.com