1StopTek

Services développeurs

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 test

Construire avec l’API 1st AI Platform.

Une 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

L’accès est réservé aux testeurs invités. L’hôte de staging prévu n’est pas encore en ligne et aucun modèle n’est connecté : les requêtes d’inférence renvoient 503 inference_unavailable. Rien n’est facturé.

Fonctionnalités

Fonctionnalités
FonctionnalitéStatutDétails
Chat completionsEn testPOST /api/v1/chat/completions avec des messages system, user et assistant ; temperature, top_p, max_tokens et stop.
StreamingEn testServer-sent events (stream: true) : événements chat.completion.chunk, puis data: [DONE].
Sortie structuréeEn testresponse_format json_object ou json_schema ; le résultat est validé par rapport à votre schéma. Non combinable avec le streaming.
EmbeddingsEn testPOST /api/v1/embeddings, jusqu'à 64 entrées de 8 000 caractères maximum chacune.
Découverte des modèlesEn testGET /api/v1/models liste chaque modèle avec ses capacités, sa fenêtre de contexte et sa limite de sortie.
API d'utilisationEn testGET /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évuImplémentée dans Eurylie avec citations ; pas encore exposée sur l'API développeur.
Appel d'outils et de fonctionsPrévuLes requêtes utilisant des outils sont rejetées avec une erreur explicite, jamais ignorées silencieusement.
Entrée image et audioNon pris en chargeTexte uniquement. Tout contenu non textuel est rejeté avec unsupported_content_type.

Les modèles et leurs limites

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.

Fenêtre de contexte
Par modèle, indiquée par GET /api/v1/models. Configuration de préproduction prévue : 4 096 tokens, prompt et sortie compris.
Sortie maximale par requête
La plus basse entre la limite de votre tier (1 024 en sandbox, 4 096 dans les tiers supérieurs) et la limite propre du modèle (1 024 dans la configuration de préproduction prévue).
Messages par requête
jusqu'à 256
Embeddings par requête
64 entrées de 8 000 caractères chacune

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

Les entrées et les sorties passent par la Safety Layer de la plateforme. Une requête refusée renvoie safety_error ; une sortie refusée se termine par finish_reason content_filter.

API et documentation

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 de base

URL
Préproduction (test)https://platform-api-staging.1stoptek.comHôte prévu, pas encore en ligne. Testeurs invités uniquement ; aucun modèle n’est encore connecté
Productionhttps://api.1stoptek.comPas encore ouvert · clés live (1stai_live_…) uniquement

Authentification

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.

Démarrage rapide

Test restreint

Les tests se font sur invitation. Les testeurs approuvés se connectent à la console, indiquent leur âge une fois (obligatoire en staging) et peuvent créer des organisations, des projets et des clés de test. Tant qu’aucun modèle qualifié pour la sécurité n’est connecté, les requêtes de chat, de streaming et d’embeddings renvoient 503 inference_unavailable, et rien n’est facturé.
  1. Demandez un accès testeur (developers@1stoptek.com), puis créez un compte 1StopTek et confirmez votre adresse e-mail.
  2. Ouvrez la console développeur et créez une organisation ; elle démarre avec un projet Default.
  3. Créez une clé d'API pour le projet. Copiez-la immédiatement : elle n'est affichée qu'une seule fois.
  4. Exportez-la en tant que FIRSTAI_API_KEY et envoyez votre première requête.
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"]}'
Sortie structurée · 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 (bibliothèque standard)
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+, sans dépendances)
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.

Limites de requêtes

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.

TierRequêtes par minute (par projet)Tokens par mois (par organisation)Tokens de sortie max.Flux simultanés
sandbox20500 0001 0242
developer12010 000 0004 09610
scale600100 000 0004 09650
enterprise3 0001 000 000 0004 096200

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.

Erreurs

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.

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}}
HTTPtypeCodes typiques
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

Nouvelles tentatives

Réessayez une 429 après Retry-After, et les 502/503/504 avec un backoff exponentiel. Ne réessayez pas à l'identique les erreurs de validation 4xx. Chaque tentative est une requête distincte et est comptabilisée séparément.

Versionnement

La version majeure figure dans le chemin (/api/v1) et dans l'en-tête X-API-Version. Au sein de v1, nous ne faisons qu'ajouter : nouveaux endpoints, nouveaux champs optionnels et nouvelles valeurs d'énumération. Les clients doivent ignorer les champs inconnus. Un changement incompatible est publié sous /api/v2, annoncé à l'avance avec une période d'abandon progressif pour v1.

Compte développeur et clés d'API

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.

De l'inscription à la première requête

  1. 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.

  2. 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.

  3. 03

    Créer une organisation

    Vous en devenez propriétaire. Un projet Default est créé avec elle.

  4. 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.

  5. 05

    Envoyer la première requête

    Utilisez le démarrage rapide avec votre clé.

  6. 06

    Consulter l'utilisation et les coûts

    Tokens, requêtes et frais estimés par projet et par clé.

Comment les clés d'API sont protégées

  • Les clés ont la forme 1stai_test_<id>_<secret>. La préproduction n'émet que des clés de test, la production que des clés live, et aucune ne fonctionne dans l'autre environnement.
  • La clé complète n'est affichée qu'une seule fois, à sa création ou à sa rotation. Ensuite, la console n'en affiche qu'un court indice.
  • La plateforme stocke un hachage à clé (HMAC-SHA-256 avec un secret côté serveur), jamais la clé elle-même. Une copie de la base de données ne suffit pas à s'authentifier.
  • Les clés sont rattachées à un seul projet et ne portent que les scopes que vous choisissez : models:read, chat:write, embeddings:write, usage:read.
  • La révocation prend effet dès la requête suivante. La rotation émet une clé de remplacement et laisse l'ancienne clé fonctionner pendant une période de grâce que vous choisissez (jusqu'à 7 jours, ou 0 pour une révocation immédiate).
  • Les organisations sont isolées les unes des autres : chaque appel à la console et à l'API est vérifié par rapport à l'organisation à laquelle appartient la clé ou le compte.

Assistants de site web

Assistants de site web pour les développeurs

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 d'installation

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.

HTML
<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é.

Version figée avec Subresource Integrity

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.

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

Options

  • data-locale="de" définit la langue.
  • Un élément avec id="1stai-agent" affiche l'assistant intégré plutôt que flottant.
  • Avec une Content Security Policy, autorisez l'origine de la plateforme dans script-src et connect-src, ainsi que les styles en ligne pour l'élément de style propre au widget.

Serveur à serveur (paramètres avancés)

Une clé agents:invoke est liée aux assistants que vous choisissez et n'a aucune autre autorisation. Conservez-la sur votre serveur ; jamais dans une page web.

Utilisation et facturation

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é.

Ce qui est comptabilisé

  • Un enregistrement par requête : organisation, projet, identifiant de clé, endpoint, modèle, statut, tokens d'entrée et de sortie, latence. Aucun contenu de prompt ni de sortie.
  • Le nombre de tokens provient du serveur de modèles lorsqu'il le communique ; sinon il est estimé et signalé comme estimé.
  • Réessayer avec une nouvelle requête crée un nouvel enregistrement. Répéter le même identifiant de requête n'est jamais compté deux fois.

Ce que vous voyez dans la console

  • Tokens et requêtes depuis le début du mois par rapport à votre quota, par projet et par clé.
  • Frais actuels estimés dès qu'une grille tarifaire s'applique, avec montants HT, TVA et TTC affichés séparément.
  • Relevés mensuels pour les mois clôturés. Les factures ne sont pas encore émises ; elles le seront à l'ouverture de l'accès payant.

Alertes et plafonds de dépenses

Seuil d'alerte

Enregistre une alerte lorsque le coût d'utilisation depuis le début du mois (avant le forfait inclus) dépasse le montant. Les requêtes continuent de fonctionner.

Plafond de dépenses strict

Les requêtes susceptibles de porter le coût d'utilisation depuis le début du mois (avant le forfait inclus) au-delà du plafond sont refusées avec 402 spending_limit_reached avant l'appel du modèle.

Requêtes en cours

Avant d'appeler un modèle, la plateforme réserve le coût maximal possible de la requête (entrée plus votre max_tokens). Les requêtes déjà admises se terminent normalement et leur coût réel ne dépasse jamais le montant réservé ; des requêtes simultanées ne peuvent donc pas dépasser ensemble un plafond strict. Une requête susceptible de dépasser le budget restant est refusée, même si son coût réel aurait été inférieur.

Si l'utilisation ne peut pas être vérifiée

Si la plateforme ne peut pas lire l'utilisation, les réservations ou les limites, elle refuse la requête avec 503 billing_unavailable. Un échec de vérification n'accorde jamais un accès illimité.

API v1 · contract 0b847d90d1

PulseChat Business API

Implémentée, non activée

La messagerie professionnelle pour les systèmes que vous utilisez déjà.

Les 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.

Deux usages pris en charge

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.

Messages transactionnels

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.

Ce qui existe et son statut

  • Réponses aux conversations ouvertes par les clientsImplémentée, non activée
  • Messages transactionnels aux clients consentantsImplémentée, non activée
  • Modèles examinés par PulseChatImplémentée, non activée
  • Bac à sable avec des clients synthétiquesImplémentée, non activée
  • Clés API à portée restreinte, avec rotation et révocationImplémentée, non activée
  • Webhooks signésImplémentée, non activée
  • Récupération des événements (polling)Implémentée, non activée
  • Limites d'utilisationImplémentée, non activée
  • Accès en production après approbation de PulseChatImplémentée, non activée
  • Chat pour site webPrévue

Ce que l'API ne fait pas

  • Ouvrir une conversation ou écrire à des clients qui n'ont ni écrit en premier ni consenti
  • Écrire à des clients qui ont bloqué l'entreprise ou retiré leur consentement
  • Envoyer des messages marketing ou en masse
  • Envoyer des codes de connexion ou de vérification

Comment les clients sont référencés

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 n'est pas encore ouverte

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.

Conçue pour de vrais flux

E-commerce

  1. Confirmation de commande
  2. Mise à jour d'expédition
  3. Mise à jour de livraison
  4. Réponse à la question du client

SaaS

Mises à jour de compte et de service, et réponses aux conversations de support ouvertes par vos clients.

Réservation

Confirmations, rappels, modifications et annulations.

Places de marché

Messages de commande et de support entre une place de marché et ses propres clients, sans partager leur numéro de téléphone.

Le trajet d'un message
  1. Votre serveur
  2. PulseChat Business API
  3. PulseChat
  4. Votre client

1Stop DataHub

Prévu

La couche de contrôle développeurs et entreprises de l'écosystème 1StopTek.

Un 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.

Ce qu'il gérera

  • Applications
  • Identifiants API
  • Webhooks
  • Équipes
  • Rôles et permissions
  • Utilisation des API
  • Analyses
  • Abonnements et facturation
  • Intégrations
  • Services 1StopTek pris en charge
Une seule couche de contrôle
Votre application1Stop DataHubPulseChat · 1st AI Platform · futures API 1StopTek

Services développeurs

Business ou Développeurs ?

1StopTek Developers

Pour les développeurs qui intègrent la technologie 1StopTek dans des applications et des services.

1Stop DataHub

La couche de gestion technique prévue qui relie applications, identifiants, permissions, utilisation et services de l'écosystème pris en charge.

Construisez avec 1StopTek

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.

developers@1stoptek.com