Endpoint

Completions

Usa POST /completions per inviare un prompt grezzo a modelli base, fill-in-the-middle e integrazioni legacy, con parametri, risposta ed errori.

Provalo nel playground

L'endpoint completions legacy riceve una stringa prompt grezza e restituisce il testo generato, senza applicare alcun template di chat. È utile per i modelli base, il fill-in-the-middle e le integrazioni più datate. Per il nuovo codice usa Chat completions.

POST https://api14.com/api/v1/completions
Authorization: Bearer sk-api14-...
Content-Type: application/json

Richiesta

Parametro	Tipo	Descrizione
`model`	string, obbligatorio	Id del modello, ad es. `meta-llama/llama-3.1-8b-instruct`.
`prompt`	string, obbligatorio	Il testo da continuare.
`max_tokens`	integer	Limite massimo di token generati.
`temperature`, `top_p`, `top_k`	number	Controlli di campionamento.
`stop`	string \| string[]	Sequenze di stop.
`seed`	integer	Campionamento deterministico, nel limite del possibile.
`logprobs`	integer	Restituisce le probabilità logaritmiche dei token principali quando il modello le supporta.
`stream`	boolean	Riceve i frammenti di testo in streaming via SSE.
`provider`, `models`, `transforms`		Le stesse estensioni del gateway di chat completions.

curl https://api14.com/api/v1/completions \
  -H "Authorization: Bearer $API14_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-3.5-turbo-instruct",
    "prompt": "The three primary colors are",
    "max_tokens": 20
  }'

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

const result = await client.chat.completions.create({
  "model": "openai/gpt-5-mini",
  "messages": [
    {
      "role": "user",
      "content": "Explain vector databases in two sentences."
    }
  ]
});
console.log(result.choices[0].message.content);

Risposta

{
  "id": "gen-1760000000-xyz789",
  "object": "text_completion",
  "created": 1760000000,
  "model": "openai/gpt-3.5-turbo-instruct",
  "choices": [
    { "index": 0, "text": " red, yellow and blue.", "finish_reason": "stop" }
  ],
  "usage": {
    "prompt_tokens": 6,
    "completion_tokens": 7,
    "total_tokens": 13,
    "cost": 0.0000195
  }
}

Errori

400 model_required, 400 invalid_json, 401 invalid_api_key, 402 insufficient_balance, 403 model_not_allowed / plan_required, 404 model_not_found, 413 payload_too_large, 429 rate_limited, 502 upstream_unavailable. Gli errori del provider vengono inoltrati con lo stato originale. Vedi Errori.