API

L'API HTTP di Skynet permette a script e strumenti di fare ciò che fa l'app web: avviare esecuzioni, seguirle e leggerne i risultati. Questa pagina mostra come firmare le richieste, dove trovare il riferimento completo e un esempio completo.

URL di base

Invia ogni richiesta a:

https://api.skynetml.com

Autenticazione

L'API usa token API.

1. Apri Impostazioni in Skynet, poi apri la scheda API.
2. Fai clic su Genera token.
3. Copia subito il token. Skynet mostra il token completo una sola volta.

Invia il token nell'intestazione Authorization di ogni richiesta:

Authorization: Bearer skyd_...

• I token iniziano con skyd_.
• Ogni utente ha al massimo un token valido. Un nuovo token disattiva quello vecchio.
• Fai clic su Revoca token per disattivare un token.

Riferimento interattivo

Il riferimento completo è su api.skynetml.com/scalar. Elenca ogni endpoint pubblico, i suoi campi e le sue risposte. Da quella pagina puoi inviare richieste di prova.

Il riferimento legge il documento OpenAPI all'indirizzo https://api.skynetml.com/openapi.public.json. Usa quel file per generare un client nel tuo linguaggio.

Endpoint principali

Avviare un'esecuzione

POST /optimize accetta la stessa configurazione della procedura guidata di invio. Questo esempio migliora un prompt che classifica i messaggi di assistenza in etichette.

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
}

Campi importanti:

• task.artifact.kind è prompt, code, text o dspy_program.
• data.mode è pairs (input con output attesi) o single (esattamente un caso).
• optimizer.choice è auto oppure il nome di un ottimizzatore restituito da GET /optimizers.
• max_cost_cents è il limite di spesa per questa esecuzione, in centesimi di dollaro USA.
• is_private è false per impostazione predefinita. Impostalo su true per mantenere privata l'esecuzione.

Leggi Metriche e scorer per le regole di run_code e metric_code.

Risposte

Seguire un'esecuzione

Interroga l'esecuzione finché il suo stato non è finale:

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

Il campo status assume uno di questi valori:

Interroga ogni 10-30 secondi. Un'esecuzione può durare da pochi minuti a diverse ore.

Il riferimento API elenca ogni campo della risposta di un'esecuzione.

Usare il risultato

Quando lo stato è success, recupera la versione migliore:

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

Per eseguire la versione migliore su un nuovo input, invia POST /serve/{optimization_id}. Leggi Risultati per il significato di ogni punteggio.

Limiti

L'API usa le stesse quote, gli stessi limiti di frequenza e la stessa fatturazione dell'app web. Leggi Limiti e Fatturazione.