Réponses aux conversations de support
Un client ouvre une conversation avec votre entreprise dans PulseChat. Votre système peut la lire et y répondre. Votre entreprise ne peut pas ouvrir ces conversations.
Services développeurs
Construisez sur l'écosystème 1StopTek.
Intégrez la communication, l'IA et l'infrastructure de données dans vos applications grâce aux services développeurs 1StopTek.
1st AI Platform API
En testUne API HTTPS versionnée pour les chat completions, le streaming, la sortie structurée et les embeddings, servie par la plateforme qu’exploite 1StopTek.
Test restreint
| Fonctionnalité | Statut | Détails |
|---|---|---|
| Chat completions | En test | POST /api/v1/chat/completions avec des messages system, user et assistant ; temperature, top_p, max_tokens et stop. |
| Streaming | En test | Server-sent events (stream: true) : événements chat.completion.chunk, puis data: [DONE]. |
| Sortie structurée | En test | response_format json_object ou json_schema ; le résultat est validé par rapport à votre schéma. Non combinable avec le streaming. |
| Embeddings | En test | POST /api/v1/embeddings, jusqu'à 64 entrées de 8 000 caractères maximum chacune. |
| Découverte des modèles | En test | GET /api/v1/models liste chaque modèle avec ses capacités, sa fenêtre de contexte et sa limite de sortie. |
| API d'utilisation | En test | GET /api/v1/usage renvoie le nombre quotidien de tokens d'un projet et les totaux depuis le début du mois. |
| Recherche documentaire (RAG) | Prévu | Implémentée dans Eurylie avec citations ; pas encore exposée sur l'API développeur. |
| Appel d'outils et de fonctions | Prévu | Les requêtes utilisant des outils sont rejetées avec une erreur explicite, jamais ignorées silencieusement. |
| Entrée image et audio | Non pris en charge | Texte uniquement. Tout contenu non textuel est rejeté avec unsupported_content_type. |
La plateforme sert des modèles open-weight sur son propre matériel d'inférence. GET /api/v1/models fait foi pour chaque environnement : chaque entrée indique ses capacités, sa fenêtre de contexte et son nombre maximal de tokens de sortie.
Le débit et la latence n'ont pas encore été mesurés sur le matériel d'inférence de production. Nous publierons des valeurs mesurées, pas des objectifs.
Safety Layer
API et documentation
L'API développeur repose sur HTTPS et JSON, avec une description OpenAPI 3.1 générée à partir du même contrat que celui sur lequel le serveur est testé.
| URL | ||
|---|---|---|
| Préproduction (test) | https://platform-api-staging.1stoptek.com | Hôte prévu, pas encore en ligne. Testeurs invités uniquement ; aucun modèle n’est encore connecté |
| Production | https://api.1stoptek.com | Pas encore ouvert · clés live (1stai_live_…) uniquement |
Envoyez la clé d'API de votre projet comme jeton bearer : Authorization: Bearer 1stai_test_…. Appelez l'API uniquement depuis votre serveur ; n'intégrez jamais une clé dans un navigateur ou une application mobile.
Test restreint
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);Il n'existe pas encore de paquet SDK dédié. Les exemples utilisent du HTTP simple ; comme les formats de requête et de réponse suivent le format chat-completions largement répandu, de nombreuses bibliothèques clientes existantes fonctionnent en changeant l'URL de base. Nous ne documentons que les clients que nous avons testés.
Chaque projet dispose d'un quota de requêtes par minute et chaque organisation d'un quota mensuel de tokens, fixés par son tier. Chaque réponse indique les requêtes restantes dans X-RateLimit-Limit-Requests et X-RateLimit-Remaining-Requests ; une réponse 429 contient Retry-After.
| Tier | Requêtes par minute (par projet) | Tokens par mois (par organisation) | Tokens de sortie max. | Flux simultanés |
|---|---|---|---|---|
| sandbox | 20 | 500 000 | 1 024 | 2 |
| developer | 120 | 10 000 000 | 4 096 | 10 |
| scale | 600 | 100 000 000 | 4 096 | 50 |
| enterprise | 3 000 | 1 000 000 000 | 4 096 | 200 |
Les nouvelles organisations démarrent en sandbox. Les tiers sont des limites, pas des prix ; les tiers supérieurs sont attribués après examen.
Toutes les erreurs ont la même structure JSON. Branchez votre logique sur type ; journalisez request_id lorsque vous contactez le support. Les messages ne contiennent jamais votre 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 | Codes typiques |
|---|---|---|
| 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 |
Nouvelles tentatives
Versionnement
Compte développeur et clés d'API
Un seul compte 1StopTek vous connecte. Les organisations, projets et clés relèvent de la plateforme ; la console les gère pour vous.
01
Créer un compte
Les tests se font sur invitation : demandez un accès testeur, puis inscrivez-vous avec e-mail et mot de passe.
02
Vérifier l'e-mail
Suivez le lien que nous vous envoyons. Les comptes non vérifiés n'ont pas accès à la console.
03
Créer une organisation
Vous en devenez propriétaire. Un projet Default est créé avec elle.
04
Générer une clé d'API
Choisissez le nom, les scopes et une expiration facultative. La clé complète n'est affichée qu'une fois.
05
Envoyer la première requête
Utilisez le démarrage rapide avec votre clé.
06
Consulter l'utilisation et les coûts
Tokens, requêtes et frais estimés par projet et par clé.
Assistants de site web
Les détails techniques derrière la configuration guidée dans la console.
Exemple uniquement : les assistants de site web ne sont pas encore disponibles pour les clients.
Le code identifie l'assistant par son identifiant public. Il ne contient aucune clé. L'assistant n'accepte les requêtes de navigateur que depuis les origines https exactes des sites dont la propriété a été confirmée. Un programme hors navigateur peut imiter une origine : les limites par visiteur, par assistant et votre limite de dépenses s'appliquent donc aussi.
<script src="https://{widget-host}/widget/v1/agent.js" data-agent="agt_…" async></script>L'hôte du widget n'est pas encore choisi ; le code affiche un espace réservé.
Le chemin stable suit les mises à jour compatibles du widget. Pour figer une version, utilisez le chemin versionné et l'empreinte d'intégrité publiée dans le manifest.json du widget.
<script src="https://{widget-host}/widget/v1/{version}/agent.js"
integrity="sha384-…" crossorigin="anonymous"
data-agent="agt_…" async></script>Options
Serveur à serveur (paramètres avancés)
Utilisation et facturation
Le comptage a lieu sur le serveur, par requête, au moment où une requête se termine. La console affiche exactement ce que la plateforme a enregistré.
Seuil d'alerte
Plafond de dépenses strict
Requêtes en cours
Si l'utilisation ne peut pas être vérifiée
API v1 · contract 0b847d90d1
PulseChat Business API
Implémentée, non activéeLes entreprises vérifiées pourront connecter leur boutique, leur outil de tickets ou leur logiciel de réservation à PulseChat : pour répondre aux conversations de support que leurs clients ouvrent, et pour envoyer des messages transactionnels aux clients qui y ont consenti.
L'API Business est implémentée et testée, mais elle n'est pas encore activée et n'a aucun développeur externe. La configuration, le bac à sable et l'accès en production ne sont pas ouverts ; cette page l'indiquera quand cela changera.
Un client ouvre une conversation avec votre entreprise dans PulseChat. Votre système peut la lire et y répondre. Votre entreprise ne peut pas ouvrir ces conversations.
Mises à jour de commande, de service, de rendez-vous et de compte, envoyées avec des modèles approuvés par PulseChat, uniquement aux clients qui ont consenti à recevoir les messages de votre entreprise. Les clients peuvent retirer leur consentement à tout moment. Le modèle de consentement définitif fait l'objet d'un examen juridique.
Votre système ne voit un client qu'à travers une référence propre à votre entreprise, pas son numéro de téléphone, son identifiant PulseChat ni son nom. Ce n'est pas de l'anonymat : les clients peuvent toujours partager des informations personnelles dans leurs propres messages.
La configuration guidée et la documentation développeur seront publiées quand PulseChat ouvrira l'API. Si vous souhaitez être pris en compte pour le pilote, contactez-nous.
Mises à jour de compte et de service, et réponses aux conversations de support ouvertes par vos clients.
Confirmations, rappels, modifications et annulations.
Messages de commande et de support entre une place de marché et ses propres clients, sans partager leur numéro de téléphone.
1Stop DataHub
PrévuUn seul endroit pour gérer les intégrations 1StopTek de votre organisation — applications, identifiants, équipes et utilisation.
Un compte. Plusieurs produits. Une plateforme.
Développeurs et organisations géreront les intégrations 1StopTek prises en charge depuis un seul environnement. Les fondations sous-jacentes — identité, rôles et permissions, droits d'accès, audit — sont en développement actif ; DataHub est le produit prévu au-dessus.
Services développeurs
Pour les organisations qui gèrent la publicité et les services commerciaux 1StopTek.
Aller sur 1StopTek Business →Pour les développeurs qui intègrent la technologie 1StopTek dans des applications et des services.
La couche de gestion technique prévue qui relie applications, identifiants, permissions, utilisation et services de l'écosystème pris en charge.
L'accès développeur à la PulseChat Business API, à l'API 1st AI Platform et à 1Stop DataHub est en préparation. Développeurs, entreprises et partenaires d'intégration : parlez-nous d'accès anticipé, d'intégrations API, d'intégrations entreprise et de partenariats.