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.
Servicios para 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 pruebasUna API HTTPS versionada para chat completions, streaming, salida estructurada y embeddings, servida por la plataforma que opera 1StopTek.
Pruebas restringidas
| Funcionalidad | Estado | Detalles |
|---|---|---|
| Chat completions | En pruebas | POST /api/v1/chat/completions con mensajes system, user y assistant; temperature, top_p, max_tokens y stop. |
| Streaming | En pruebas | Server-sent events (stream: true): eventos chat.completion.chunk y, después, data: [DONE]. |
| Salida estructurada | En pruebas | response_format json_object o json_schema; el resultado se valida contra tu esquema. No combinable con streaming. |
| Embeddings | En pruebas | POST /api/v1/embeddings, hasta 64 entradas de hasta 8000 caracteres cada una. |
| Descubrimiento de modelos | En pruebas | GET /api/v1/models lista cada modelo con sus capacidades, su ventana de contexto y su límite de salida. |
| API de uso | En pruebas | GET /api/v1/usage devuelve el recuento diario de tokens de un proyecto y los totales del mes en curso. |
| Recuperación de documentos (RAG) | Previsto | Implementada en Eurylie con citas; todavía no expuesta en la API para desarrolladores. |
| Llamada a herramientas y funciones | Previsto | Las solicitudes que usan herramientas se rechazan con un error explícito, nunca se ignoran en silencio. |
| Entrada de imagen y audio | No compatible | Solo texto. El contenido que no es texto se rechaza con unsupported_content_type. |
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.
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
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 | ||
|---|---|---|
| Staging (pruebas) | https://platform-api-staging.1stoptek.com | Host previsto, aún no está en línea. Solo testers invitados; aún no hay ningún modelo conectado |
| Producción | https://api.1stoptek.com | Aún no abierto · solo claves live (1stai_live_…) |
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.
Pruebas restringidas
export FIRSTAI_BASE_URL=https://platform-api-staging.1stoptek.com
export FIRSTAI_API_KEY=1stai_test_... # from the developer consolecurl -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
}'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]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"]}'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"]
}
}
}
}'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"])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.
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.
| Tier | Solicitudes por minuto (por proyecto) | Tokens por mes (por organización) | Tokens de salida máx. | Streams simultáneos |
|---|---|---|---|---|
| sandbox | 20 | 500.000 | 1024 | 2 |
| developer | 120 | 10.000.000 | 4096 | 10 |
| scale | 600 | 100.000.000 | 4096 | 50 |
| enterprise | 3000 | 1.000.000.000 | 4096 | 200 |
Las nuevas organizaciones empiezan en sandbox. Los tiers son límites, no precios; los tiers superiores se asignan tras una revisión.
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.
{"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}}| HTTP | type | Códigos habituales |
|---|---|---|
| 400 | invalid_request_error | invalid_messages, unsupported_parameter, context_length_exceeded |
| 401 | authentication_error | invalid_api_key |
| 402 | quota_exceeded_error | monthly_quota_exceeded, spending_limit_reached |
| 403 | permission_error | forbidden, organization_suspended |
| 404 | not_found_error | model_not_found |
| 409 | conflict_error | key_limit_reached, project_archived |
| 422 | safety_error | safety_refused |
| 429 | rate_limit_error | rate_limited, too_many_streams |
| 502 / 504 | model_error | model_error, model_timeout, invalid_structured_output |
| 503 | service_unavailable_error | model_unavailable, billing_unavailable |
Reintentos
Versionado
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.
01
Crear la cuenta
Las pruebas son por invitación: solicita acceso de tester y después regístrate con correo y contraseña.
02
Verificar el correo
Sigue el enlace que te enviamos. Las cuentas no verificadas no pueden acceder a la consola.
03
Crear la organización
Te conviertes en su propietario. Con ella se crea un proyecto Default.
04
Generar una clave de API
Elige nombre, scopes y una caducidad opcional. La clave completa se muestra una sola vez.
05
Enviar la primera solicitud
Usa el inicio rápido con tu clave.
06
Ver uso y costes
Tokens, solicitudes y cargos estimados por proyecto y por clave.
Asistentes para sitios web
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 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.
<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.
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.
<script src="https://{widget-host}/widget/v1/{version}/agent.js"
integrity="sha384-…" crossorigin="anonymous"
data-agent="agt_…" async></script>Opciones
De servidor a servidor (ajustes avanzados)
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.
Umbral de alerta
Límite de gasto estricto
Solicitudes en curso
Si no se puede comprobar el uso
API v1 · contract 0b847d90d1
PulseChat Business API
Implementada, no activadaLas 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.
Un cliente inicia una conversación con tu empresa en PulseChat. Tu sistema puede leerla y responder. Tu empresa no puede iniciar estas conversaciones.
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.
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 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.
Actualizaciones de cuenta y de servicio, y respuestas a las conversaciones de soporte que inician tus clientes.
Confirmaciones, recordatorios, cambios y cancelaciones.
Mensajes de pedidos y soporte entre un marketplace y sus propios clientes, sin compartir sus números de teléfono.
1Stop DataHub
PlanificadoUn 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.
Servicios para desarrolladores
Para organizaciones que gestionan publicidad y servicios comerciales de 1StopTek.
Ir a 1StopTek Business →Para desarrolladores que integran tecnología 1StopTek en aplicaciones y servicios.
La capa técnica de gestión planificada que conecta aplicaciones, credenciales, permisos, uso y servicios compatibles del ecosistema.
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.