API

L'API HTTP de Skynet permet à des scripts et à des outils de faire ce que fait l'application web : lancer des exécutions, les suivre et lire leurs résultats. Cette page explique comment signer les requêtes, où trouver la référence complète, et donne un exemple complet.

URL de base

Envoyez chaque requête à :

https://api.skynetml.com

Authentification

L'API utilise des jetons d'API.

1. Ouvrez les Paramètres dans Skynet, puis l'onglet API.
2. Cliquez sur Générer un jeton.
3. Copiez immédiatement le jeton. Skynet n'affiche le jeton complet qu'une seule fois.

Envoyez le jeton dans l'en-tête Authorization de chaque requête :

Authorization: Bearer skyd_...

• Les jetons commencent par skyd_.
• Chaque utilisateur possède au plus un jeton valide. Un nouveau jeton désactive l'ancien.
• Cliquez sur Révoquer le jeton pour désactiver un jeton.

Référence interactive

La référence complète se trouve sur api.skynetml.com/scalar. Elle liste chaque point de terminaison public, ses champs et ses réponses. Vous pouvez envoyer des requêtes de test depuis cette page.

La référence lit le document OpenAPI à l'adresse https://api.skynetml.com/openapi.public.json. Utilisez ce fichier pour générer un client dans votre langage.

Principaux points de terminaison

Lancer une exécution

POST /optimize accepte la même configuration que l'assistant de soumission. Cet exemple améliore un prompt qui classe des messages de support selon des étiquettes.

curl https://api.skynetml.com/optimize \
  -H "Authorization: Bearer $SKYNET_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: support-labels-001" \
  -d @run.json

{
  "name": "Support labels",
  "task": {
    "objective": "Sort each support message into billing, bug or other.",
    "artifact": {
      "kind": "prompt",
      "starting_version": "Label this support message as billing, bug or other."
    }
  },
  "data": {
    "mode": "pairs",
    "cases": [
      { "input": { "message": "I was charged twice." }, "expected": { "label": "billing" } },
      { "input": { "message": "The export button does nothing." }, "expected": { "label": "bug" } },
      {
        "input": { "message": "Do you have a Hebrew interface?" },
        "expected": { "label": "other" }
      }
    ]
  },
  "optimizer": { "choice": "auto", "budget": { "max_scorer_runs": 200 } },
  "models": {
    "task_model": { "name": "<model from GET /models>" },
    "reflection_model": { "name": "<model from GET /models>" }
  },
  "workspace": {
    "run_code": "from skynet import llm\n\ndef run(artifact, input):\n    return llm(artifact, input=input[\"message\"])\n",
    "metric_code": "def score(input, output, expected=None):\n    ok = str(output).strip().lower() == expected[\"label\"]\n    return (1.0 if ok else 0.0), {\"feedback\": \"Correct.\" if ok else \"Wrong label.\"}\n"
  },
  "max_cost_cents": 500
}

Champs importants :

• task.artifact.kind vaut prompt, code, text ou dspy_program.
• data.mode vaut pairs (des entrées avec des sorties attendues) ou single (exactement un cas).
• optimizer.choice vaut auto ou le nom d'un optimiseur renvoyé par GET /optimizers.
• max_cost_cents est le plafond de dépenses de cette exécution, en cents de dollar américain.
• is_private vaut false par défaut. Passez-le à true pour garder l'exécution privée.

Lisez Métriques et évaluateurs pour les règles de run_code et metric_code.

Réponses

Suivre une exécution

Interrogez l'exécution jusqu'à ce que son statut soit final :

curl https://api.skynetml.com/optimizations/$RUN_ID \
  -H "Authorization: Bearer $SKYNET_TOKEN"

Le champ status prend l'une des valeurs suivantes :

Interrogez toutes les 10 à 30 secondes. Une exécution peut durer de quelques minutes à plusieurs heures.

La référence de l'API liste chaque champ de la réponse d'une exécution.

Utiliser le résultat

Quand le statut est success, récupérez la meilleure version :

curl https://api.skynetml.com/optimizations/$RUN_ID/artifact \
  -H "Authorization: Bearer $SKYNET_TOKEN"

Pour exécuter la meilleure version sur une nouvelle entrée, envoyez POST /serve/{optimization_id}. Lisez Résultats pour la signification de chaque score.

Limites

L'API applique les mêmes quotas, limites de débit et règles de facturation que l'application web. Lisez Limites et Facturation.