Referencia de la API

Completions de texto

POST /v1/completions para el formato legado, con un prompt de entrada y texto de salida.

El endpoint de prompt legado, para las herramientas que todavía lo hablan. Ejecuta el prompt como un único mensaje de usuario sobre los mismos modelos. Para todo lo nuevo, usa chat completions.

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

POST https://api.notholy.com/v1/completions

Solicitud

Campo	Tipo	Obligatorio	Notas
`model`	string	Sí	Un ID de modelo
`prompt`	string o array	Sí	Un string o un array con exactamente un string
`max_tokens`	number	No	Por defecto es 16. Limitado a la salida máxima del modelo
`stream`	boolean	No	`true` devuelve chunks `text_completion` y `data: [DONE]`
`temperature`, `top_p`, `stop`		No	Se pasan al modelo
`n`	number	No	Solo `1`

Aquí no hay herramientas ni esfuerzo de razonamiento. echo, logprobs y suffix se ignoran.

Respuesta

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 }
}

En un stream, cada chunk trae choices[0].text. El último chunk tiene finish_reason y usage.

Ejemplo

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}'

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.notholy.com/v1", api_key=os.environ["NOTHOLY_API_KEY"])

r = client.completions.create(model="notholy-specter", prompt="The OWASP category for SSRF is", max_tokens=30)
print(r.choices[0].text)

Errores

400 falta prompt, hay más de un prompt o n es mayor que 1 · 401 clave inválida · 402 sin créditos · 404 modelo desconocido · 429 ocupado · 503 modelo no disponible. Consulta Errores.