דילוג לתוכן
NotHolyתיעוד

מדריך API

השלמות טקסט

POST /v1/completions, לפורמט הישן שבו נכנס פרומפט ויוצא טקסט.

להציג כ-Markdown

ה-endpoint הישן של פרומפט, לכלים שעדיין עובדים איתו. הוא מריץ את הפרומפט כהודעת משתמש אחת על אותם מודלים. לכל דבר חדש עדיף chat completions.

POSThttps://api.notholy.com/v1/completions

בקשה

שדהסוגחובההערות
modelstringכןמזהה מודל
promptstring או arrayכןמחרוזת, או מערך עם מחרוזת אחת בדיוק
max_tokensnumberלאברירת המחדל היא 16. מוגבל לפלט המקסימלי של המודל
streambooleanלאtrue מחזיר מקטעים מסוג text_completion ואחריהם data: [DONE]
temperature, top_p, stopלאמועברים למודל
nnumberלארק 1

אין כאן כלים ואין מאמץ חשיבה. השדות echo, logprobs וגם suffix לא נלקחים בחשבון.

תגובה

JSON
{
  "id": "cmpl-4Qz7",
  "object": "text_completion",
  "created": 1793836800,
  "model": "notholy-specter",
  "choices": [{ "index": 0, "text": " ../../etc/passwd encoded as %2e%2e%2f…", "finish_reason": "length", "logprobs": null }],
  "usage": { "prompt_tokens": 14, "completion_tokens": 60, "total_tokens": 74 }
}
  • בסטרימינג, כל מקטע מכיל את choices[0].text. המקטע האחרון מכיל את finish_reason ואת usage.

דוגמה

curl https://api.notholy.com/v1/completions \
  -H "Authorization: Bearer $NOTHOLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "notholy-specter", "prompt": "A path traversal payload in a file download parameter looks like", "max_tokens": 60}'

שגיאות

400 חסר prompt, יש יותר מפרומפט אחד, או שהערך n גדול מ-1 · 401 מפתח שגוי · 402 נגמרו הקרדיטים · 404 מודל לא מוכר · 429 עומס · 503 המודל לא זמין. הפירוט בעמוד שגיאות.