Skip to navigation
API Reference

OpenAI-compatible completions endpoint

View as Markdown

Request

This endpoint expects an object.
modelstringRequired
The model to use.
promptlist of integers or list of lists of integers or string or list of stringsRequired
echoboolean or nullOptionalDefaults to false
If true, echo back the prompt in addition to the completion. 'echo' and 'stream' fields cannot be true simultaneously.
frequency_penaltydouble or nullOptional-2-2Defaults to 0

Number between -2.0 and 2.0. Positive values penalize new tokens based on their existing frequency in the text so far, decreasing the model’s likelihood to repeat the same line verbatim.

logit_biasmap from strings to doubles or nullOptional

Modify the likelihood of specified tokens appearing in the completion. Accepts a JSON object that maps tokens (specified by their token ID in the tokenizer) to an associated bias value from -100 to 100. Mathematically, the bias is added to the logits generated by the model prior to sampling. The exact effect will vary per model, but values between -1 and 1 should decrease or increase likelihood of selection; values like -100 or 100 should result in a ban or exclusive selection of the relevant token.

logprobsinteger or nullOptional0-5

Include the log probabilities on the logprobs most likely output tokens, as well the chosen tokens. For example, if logprobs is 5, the API will return a list of the 5 most likely tokens. The API will always return the logprob of the sampled token, so there may be up to logprobs+1 elements in the response.

max_tokensinteger or nullOptional>=1Defaults to 16
The maximum number of tokens that can be generated.
ninteger or nullOptional1-128Defaults to 1
How many completions to generate for each prompt.
presence_penaltydouble or nullOptional-2-2Defaults to 0

Number between -2.0 and 2.0. Positive values penalize new tokens based on whether they appear in the text so far, increasing the model’s likelihood to talk about new topics.

seedinteger or nullOptional-9223372036854776000-9223372036854776000
Changing the seed will produce a different response with similar characteristics. Fixing the seed will reproduce the same results if all other parameters are also kept constant.
stopstring or list of strings or nullOptional
Sequences where the API will stop generating further tokens.
streamboolean or nullOptionalDefaults to false

If set, partial message deltas will be sent, like in ChatGPT. Tokens will be sent as data-only server-sent events as they become available, with the stream terminated by a data: [DONE]

stream_optionsobject or nullOptional
suffixstring or nullOptional
The suffix that comes after a completion of inserted text.
temperaturedouble or nullOptional0-2Defaults to 1
What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic.
top_pdouble or nullOptional<=1Defaults to 1

An alternative to sampling with temperature, called nucleus sampling, where the model considers the results of the tokens with top_p probability mass. So 0.1 means only the tokens comprising the top 10% probability mass are considered. We generally recommend altering this or temperature but not both.

userstring or nullOptional
min_pdoubleOptionalDefaults to 0
prompt_logprobsinteger or nullOptional
add_special_tokensbooleanOptionalDefaults to true

If true (the default), special tokens (e.g. BOS) will be added to the prompt.

response_formatobject or nullOptional

An object specifying the format that the model must output. Setting to { "type": "json_object" } enables JSON mode, which guarantees the message the model generates is valid JSON.

guided_whitespace_patternstring or nullOptional
If specified, will override the default whitespace pattern for guided json decoding.
nvextobject or nullOptional
Extension dictionary for NIM API.

Response

Successful Response
CompletionResponseobject
OR
CompletionStreamResponseobject

Errors

400
Bad Request Error
404
Not Found Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
500
Internal Server Error