API

ה-HTTP API של Skynet מאפשר לסקריפטים ולכלים לעשות את מה שאפליקציית הווב עושה: להפעיל ריצות, לעקוב אחריהן ולקרוא את התוצאות. העמוד הזה מראה איך לחתום על בקשות, איפה נמצא התיעוד המלא, ודוגמה מלאה אחת.

כתובת הבסיס

שלח/י כל בקשה אל:

https://api.skynetml.com

אימות

ה-API משתמש ב-API tokens.

1. פתח/י את הגדרות ב-Skynet, ואז פתח/י את הלשונית API.
2. לחץ/י על צור/צרי טוקן.
3. העתק/י את ה-token מיד. ‏Skynet מציג את ה-token המלא פעם אחת בלבד.

שלח/י את ה-token בכותרת Authorization של כל בקשה:

Authorization: Bearer skyd_...

• tokens מתחילים ב-skyd_.
• לכל משתמש יש לכל היותר token תקף אחד. token חדש מבטל את ה-token הישן.
• לחץ/י על בטל/י טוקן כדי לבטל token.

תיעוד אינטראקטיבי

התיעוד המלא נמצא ב-api.skynetml.com/scalar. הוא מפרט כל endpoint ציבורי, את השדות שלו ואת התגובות שלו. אפשר לשלוח בקשות בדיקה מהדף הזה.

התיעוד קורא את מסמך ה-OpenAPI ב-https://api.skynetml.com/openapi.public.json. אפשר להשתמש בקובץ הזה כדי ליצור לקוח בשפה שלך.

endpoints עיקריים

הפעלת ריצה

POST /optimize מקבל את אותן הגדרות כמו אשף ההגשה. הדוגמה הזו משפרת פרומפט שממיין הודעות תמיכה לתוויות.

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
}

שדות חשובים:

• task.artifact.kind הוא prompt,‏ code,‏ text או dspy_program.
• data.mode הוא pairs (קלטים עם פלטים צפויים) או single (מקרה אחד בדיוק).
• optimizer.choice הוא auto או שם של אופטימייזר אחד מ-GET /optimizers.
• max_cost_cents היא תקרת ההוצאה של הריצה הזו, בסנטים אמריקאיים.
• is_private הוא false כברירת מחדל. הגדר/י אותו ל-true כדי לשמור על הריצה פרטית.

קרא/י את פונקציות מדידה ופונקציות ציון לכללים של run_code ו-metric_code.

תגובות

מעקב אחרי ריצה

בדוק/בדקי את הריצה שוב ושוב עד שהסטטוס שלה סופי:

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

השדה status הוא אחד מאלה:

מומלץ לבדוק כל 10 עד 30 שניות. ריצה יכולה להימשך מדקות עד שעות.

הפניית ה-API מציגה כל שדה בתגובת הריצה.

שימוש בתוצאה

כשהסטטוס הוא success, קבל/י את הגרסה הטובה ביותר:

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

כדי להריץ את הגרסה הטובה ביותר על קלט חדש, שלח/י POST /serve/{optimization_id}. קרא/י את תוצאות כדי להבין מה כל ציון אומר.

מגבלות

ה-API משתמש באותן מכסות, מגבלות קצב וחיוב כמו אפליקציית הווב. קרא/י את מגבלות ואת חיוב.