Complétions de chat

Générez des complétions de chat à partir d'une liste de messages — le point d'accès principal pour la génération de texte avec tous les modèles pris en charge.

Générez une complétion de chat à partir d'une liste de messages. C'est le point d'accès principal pour la génération de texte avec tous les modèles pris en charge.

Corps de la requête

Exemple de requête

import Tchavi from '@tchavi/sdk';

const client = new Tchavi({ apiKey: 'YOUR_API_KEY' });

const response = await client.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [
    { role: 'system', content: 'Tu es un assistant utile.' },
    { role: 'user', content: 'Quelle est la capitale du Bénin ?' },
  ],
  temperature: 0.7,
});

console.log(response.choices[0].message.content);
console.log('Crédits utilisés :', response.tchavi.credits_used);

Exemple de réponse

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1711234567,
  "model": "gpt-4o-mini",
  "system_fingerprint": null,
  "service_tier": null,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "La capitale du Bénin est Porto-Novo.",
        "refusal": null
      },
      "finish_reason": "stop",
      "logprobs": null
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 12,
    "total_tokens": 36,
    "prompt_tokens_details": { "cached_tokens": 0, "cache_write_tokens": 0, "audio_tokens": 0 },
    "completion_tokens_details": { "reasoning_tokens": 0, "audio_tokens": 0 }
  },
  "tchavi": {
    "budget_group": "BUDGET",
    "model_credits_per_1k": { "input": 1, "output": 2 },
    "model_type": "chat",
    "credits_used": 3,
    "credits_remaining": 1297
  }
}

L'objet tchavi est ajouté à chaque réponse non streamée : credits_used est le coût de cet appel, credits_remaining votre solde après celui-ci, et model_credits_per_1k les taux du modèle. Les SDK OpenAI ignorent ce champ supplémentaire.

Ce que la réponse garantit

Tchavi dessert plusieurs fournisseurs derrière une seule API, et le modèle que vous nommez peut être servi par un autre. Ces garanties valent quel que soit celui qui répond : vous n'avez jamais besoin d'un cas particulier par fournisseur.

model est l'identifiant que vous avez demandé — jamais le nom que le fournisseur lui donne. Demandez gpt-5-nano et vous recevez gpt-5-nano, pas gpt-5-nano-2025-08-07 : la réponse reste donc toujours comparable à votre requête.

id est l'identifiant de cette requête. C'est chatcmpl- suivi de la valeur de l'en-tête X-Request-Id (resp_ sur /v1/responses, msg_ sur /v1/messages). Tous les fragments d'un flux portent le même. Communiquez-le au support et la requête peut être retrouvée.

La forme ne varie pas. system_fingerprint et service_tier sont toujours présents et toujours null : ils décrivent une configuration serveur en amont et un palier commercial OpenAI, que cette API ne vend pas — votre propre palier se trouve dans tchavi. refusal et les deux blocs de détail d'usage sont eux aussi toujours présents : les lire ne renvoie jamais undefined.

Le texte de raisonnement suit le modèle que vous avez nommé. Les modèles qui publient leur raisonnement renvoient message.reasoning, et delta.reasoning en streaming. Ceux qui ne le font pas — dont la famille de modèles de raisonnement d'OpenAI — ne renvoient aucun texte, tout en déclarant completion_tokens_details.reasoning_tokens, facturés comme de la sortie. C'est le comportement natif de chaque modèle.

Streaming

Définissez stream: true pour recevoir la réponse token par token sous forme de Server-Sent Events (SSE). Cela vous permet d'afficher le texte au fur et à mesure de son arrivée plutôt que d'attendre la réponse complète.

import Tchavi from '@tchavi/sdk';

const client = new Tchavi({ apiKey: process.env.TCHAVI_API_KEY });

const stream = await client.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [{ role: 'user', content: 'Raconte-moi une courte histoire.' }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}