Référence API

Documentation complète de l'API

URL de base

https://api.thistoken.ai

Authentification

Toutes les requêtes API doivent inclure la clé API dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Points de terminaison

POST/v1/chat/completions

Créer une complétion de chat

Paramètres

Nom	Type	Requis	Description
model	string	Oui	Nom du modèle, p. ex. gpt-4o, claude-3.5-sonnet
messages	array	Oui	Tableau de messages avec role et content
temperature	number	Non	Température d'échantillonnage, 0-2, défaut 1
max_tokens	integer	Non	Nombre maximum de tokens à générer
stream	boolean	Non	Diffuser la réponse, défaut false

Exemple de requête

curl https://api.thistoken.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

POST/v1/embeddings

Créer des vecteurs d'embedding texte

Paramètres

Nom	Type	Requis	Description
model	string	Oui	Nom du modèle d'embedding, p. ex. text-embedding-3-small
input	string\|array	Oui	Texte à incorporer

Exemple de requête

curl https://api.thistoken.ai/v1/embeddings \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "Hello world"
  }'

GET/v1/models

Obtenir la liste des modèles disponibles

Exemple de requête

curl https://api.thistoken.ai/v1/models \
  -H "Authorization: Bearer $API_KEY"

POST/v1/images/generations

Générer des images

Paramètres

Nom	Type	Requis	Description
model	string	Oui	Modèle d'image, p. ex. dall-e-3
prompt	string	Oui	Description de l'image
size	string	Non	Taille de l'image, p. ex. 1024x1024

Exemple de requête

curl https://api.thistoken.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A cute cat",
    "size": "1024x1024"
  }'

Codes d'erreur

Code	Description
400	Paramètres de requête invalides
401	Échec d'authentification — clé API invalide
402	Solde insuffisant
429	Limite de taux dépassée
500	Erreur interne du serveur