Documentation de l'API

https://ai.pinstudio.ch/api/v1

Dans un client compatible OpenAI — éditeur, extension, bibliothèque —, renseignez cette adresse comme base URL et votre clé comme API key. Sélectionnez le mode Chat Completions textuel.

curl https://ai.pinstudio.ch/api/v1/chat/completions \
  -H "Authorization: Bearer pinai_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bunny-1",
    "messages": [{ "role": "user", "content": "Bonjour." }]
  }'

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://ai.pinstudio.ch/api/v1",
  apiKey: process.env.PINAI_API_KEY,
});

const reponse = await client.chat.completions.create({
  model: "bunny-1",
  messages: [{ role: "user", content: "Bonjour." }],
});

console.log(reponse.choices[0].message.content);

Authorization: Bearer pinai_…

Une clé porte les autorisations que vous lui donnez, et rien de plus. La génération exige ai.generate ; les connaissances d'équipe exigent en plus team_knowledge.read.

POST/api/v1/chat/completions

Les messages system deviennent des consignes : elles se greffent sur l'identité de l'assistant au lieu de la remplacer. Un assistant sait toujours comment il s'appelle et qui l'édite, quelles que soient vos consignes.

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "created": 1789000000,
  "model": "bunny-1",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Bonjour." },
      "finish_reason": "stop"
    }
  ]
}

{
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": null,
        "tool_calls": [
          {
            "id": "call_…",
            "type": "function",
            "function": { "name": "lire_fichier", "arguments": "{\"chemin\":\"src/index.ts\"}" }
          }
        ]
      },
      "finish_reason": "tool_calls"
    }
  ]
}

En flux, les événements suivent la forme habituelle : un premier morceau portant le rôle, des morceaux de texte, un dernier portant finish_reason, puis [DONE]. La raison de fin vaut length si le plafond de sortie est atteint, ou content_filter si le fournisseur filtre la réponse. En cas de panne ou de flux incomplet, un événement error remplace la fin réussie. Un appel d'outil arrive dans un seul morceau, complet, indexé comme chez OpenAI : un argument JSON n'est exécutable qu'entier, et il n'y a donc rien à accumuler.

data: {"object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}], …}
data: {"object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Bon"},"finish_reason":null}], …}
data: {"object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"jour."},"finish_reason":null}], …}
data: {"object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}], …}
data: [DONE]

POST/api/v1/responses

{
  "id": "resp_…",
  "object": "response",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [{ "type": "output_text", "text": "Bonjour." }]
    }
  ],
  "output_text": "Bonjour.",
  "finish_reason": "stop",
  "sources": [],
  "usage": { "remaining_percent": null, "credits_remaining_micros": 9998650 }
}

sources ne se remplit qu'avec organization_id : il nomme les documents d'équipe qui ont servi, et la page où ils ont été lus.

En flux, chaque ligne est un objet complet : response.created, puis des response.output_text.delta, puis response.completed. Une panne du fournisseur arrive comme une ligne error au milieu du flux, avec un statut HTTP déjà envoyé — vérifiez le type de chaque ligne plutôt que le seul code de réponse. La raison de fin se trouve dans response.finish_reason en flux, et dans finish_reason hors flux.

Avec tools, les appels décidés arrivent hors flux dans tool_calls, à côté de output_text, et en flux dans une ligne response.tool_calls puis dans response.completed. La raison de fin vaut alors tool_calls, et output_text peut être vide : le tour de parole est le vôtre.

GET/api/v1/models

{
  "object": "list",
  "default_id": "bunny-1",
  "data": [
    {
      "id": "bunny-1",
      "object": "model",
      "name": "Bunny 1",
      "description": "Léger et économe.",
      "available": true
    }
  ]
}

id est le nom à passer dans model ou assistant_id. Une liste vide signifie qu'aucun assistant n'est ouvert à votre type d'accès — pour une clé d'intégration, c'est le cas tant qu'aucun tarif n'est publié. Les tarifs figurent page Modèles.

GET/api/v1/usage

Les tarifs s'expriment en euros par million de jetons, hors taxes, et diffèrent à l'entrée et à la sortie. Ils figurent page Modèles. Le prix d'un appel se calcule sur les jetons réellement consommés, pas sur le plafond demandé.

{ "error": { "message": "Crédits insuffisants pour cette demande.", "type": "insufficient_credits" } }

Le délai de génération dépend du fournisseur et du client. PinCode impose un plafond de quinze minutes. Un flux interrompu par le client reste facturé pour ce qui a déjà été produit.