Reference de l'API REST

Reference complete de l'API Parsyn accessible a https://parsyn.progatis.com/api/v1. Tous les endpoints necessitent une authentification sauf mention contraire.

Authentification

L'API utilise des bearer tokens JWT :

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Les tokens sont aussi definis comme cookies httpOnly lors de la connexion, ce qui permet au dashboard de s'authentifier automatiquement.

Cycle de vie des tokens

Auth

Inscription

{
  "email": "[email protected]",
  "password": "securePassword123",
  "username": "johndoe"
}

// Response 201
{
  "id": 1,
  "email": "[email protected]",
  "username": "johndoe",
  "created_at": "2026-03-10T14:30:00Z"
}

Connexion

{
  "email": "[email protected]",
  "password": "securePassword123"
}

// Response 200
{
  "access_token": "eyJhbGci...",
  "refresh_token": "eyJhbGci...",
  "token_type": "bearer",
  "user": {
    "id": 1,
    "email": "[email protected]",
    "username": "johndoe"
  }
}

Refresh token

Utilisateur courant

Mise a jour du profil

Sessions

Lister les sessions actives, revoquer une session specifique, ou revoquer toutes les sessions sauf la session en cours.

Authentification a deux facteurs

Datasets

Lister les datasets

Creer un dataset

Consulter / Modifier / Supprimer un dataset

Flux d'upload

Operations

Modeles

// From HuggingFace
{ "name": "llama-3.1-8b", "huggingface_id": "meta-llama/Llama-3.1-8B" }

// Custom upload
{ "name": "my-custom-model", "description": "Proprietary architecture" }

Training Jobs

Lister les workers disponibles

Renvoie les workers (vos propres workers et les Parsyn Workers) disponibles pour l'assignation de jobs.

Lister / Creer / Consulter

{
  "name": "llama-customer-support-v1",
  "dataset_id": 42,
  "model_id": 7,
  "config": {
    "epochs": 3,
    "batch_size": 4,
    "learning_rate": 2e-4,
    "max_length": 1024,
    "mixed_precision": "bf16",
    "use_peft": true,
    "lora_r": 16
  },
  "worker_selection": {
    "mode": "auto"
  }
}

Demarrer / Annuler / Supprimer

Metriques

Workers (vos GPUs)

Les workers sont crees automatiquement via le flux d'enrolement (WebSocket /ws/worker avec une cle enroll_...). Il n'y a pas d'endpoint de creation manuelle.

Cles d'enrolement principales

{
  "name": "production-fleet",
  "auto_name_prefix": "prod-worker",
  "default_worker_type": "both",
  "max_enrollments": 50,
  "expires_at": "2027-01-01T00:00:00Z"
}

Chat / Inference

Discuter avec un modele

{
  "message": "Explain gradient descent in simple terms.",
  "temperature": 0.7,
  "max_tokens": 500,
  "top_p": 0.9,
  "top_k": 50,
  "repetition_penalty": 1.1,
  "conversation_id": null
}

Renvoie un flux SSE avec Accept: text/event-stream, ou du JSON dans le cas contraire. Necessite un worker utilisateur en ligne avec la capacite prompter ou both.

Comparer des modeles

{
  "message": "What is overfitting?",
  "compare_model_id": 8,
  "temperature": 0.7
}

Credits

Consulter le solde

// Response
{ "balance": 5000 }

Acheter des credits

Initie une session de paiement Stripe pour le pack de credits selectionne.

Estimer le cout d'un job

{
  "gpu_type": "a100_80gb",
  "estimated_hours": 2
}

// Response
{ "estimated_credits": 400, "credits_per_hour": 200 }

Historique des transactions

Packs de credits

Evaluations

Suites d'evaluation

Pipelines

Les pipelines automatisent des workflows multi-etapes : entrainer, evaluer, exporter. Chaque etape depend de la precedente.

Donnees synthetiques

Generez, augmentez, paraphrasez ou filtrez des datasets en utilisant un LLM comme backend de generation.

{
  "name": "augment-customer-support",
  "job_type": "augment",
  "source_dataset_id": 42,
  "target_count": 5000,
  "llm_provider": "openai",
  "llm_model": "gpt-4o"
}

Types de job disponibles : generate, augment, paraphrase, filter.

Export de modeles

Exportez un modele fine-tune vers un format optimise pour l'inference.

{
  "export_type": "gguf",
  "quantization": "q4_k_m"
}

Formats supportes : gguf (llama.cpp), onnx, gptq, awq.

Organisations

Les organisations regroupent des utilisateurs en equipes et partagent les ressources (datasets, modeles, jobs) au niveau projet.

Equipes

Membres d'une equipe

Projets

Abonnements

Les plans d'abonnement definissent des quotas (jobs simultanes, stockage, etc.) en complement de la facturation au credit.

Initie une session de paiement Stripe pour souscrire ou changer de plan.

Ouvre le portail Stripe pour gerer l'abonnement en cours (annulation, mise a jour du moyen de paiement).

Liste les plans disponibles avec leurs quotas et tarifs.

Presets d'entrainement

Configurations d'entrainement preconfigrees (templates) que vous pouvez appliquer directement lors de la creation d'un training job.

Arena

Pagination

Tous les endpoints de liste renvoient des resultats pagines :

{
  "items": [...],
  "total": 150,
  "page": 1,
  "per_page": 20
}

Taille de page par defaut : 20, maximum : 100.

Reponses d'erreur

{ "detail": "Dataset not found", "status_code": 404 }