Create completion
Generate text completions for a given prompt using a language, code, or image model.
Authorization
bearerAuth In: header
Request Body
application/json
A string providing context for the model to complete.
The name of the model to query. See all of Together AI's chat models
The maximum number of tokens to generate.
A list of string sequences that truncate (stop) inference text output. For example, "" stops generation as soon as the model generates the given token.
A decimal number from 0-1 that determines the degree of randomness in the response. A temperature less than 1 favors more correctness and is appropriate for question answering or summarization. A value closer to 1 introduces more randomness in the output.
A percentage (also called the nucleus parameter) that's used to dynamically adjust the number of choices for each predicted token based on the cumulative probabilities. It specifies a probability threshold below which all less likely tokens are filtered out. This technique helps maintain diversity and generate more fluent and natural-sounding text.
An integer that's used to limit the number of choices for the next predicted word or token. It specifies the maximum number of tokens to consider at each step, based on their probability of occurrence. This technique helps to speed up the generation process and can improve the quality of the generated text by focusing on the most likely options.
A number that controls the diversity of generated text by reducing the likelihood of repeated sequences. Higher values decrease repetition.
If true, stream tokens as Server-Sent Events as the model generates them instead of waiting for the full model response. The stream terminates with data: [DONE]. If false, return a single JSON object containing the results.
An integer between 0 and 20 of the top k tokens to return log probabilities for at each generation step, instead of only the sampled token. Log probabilities help assess model confidence in token predictions.
0 <= value <= 20If true, the response contains the prompt. Can be used with logprobs to return prompt logprobs.
The number of completions to generate for each prompt.
1 <= value <= 128The name of the moderation model used to validate tokens. Choose from the available moderation models found here.
A number between 0 and 1 that can be used as an alternative to top-p and top-k.
A number between -2.0 and 2.0 where a positive value increases the likelihood of a model talking about new topics.
A number between -2.0 and 2.0 where a positive value decreases the likelihood of repeating tokens that have already been mentioned.
Adjusts the likelihood of specific tokens appearing in the generated output.
Seed value for reproducibility.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/completions" \ -H "Content-Type: application/json" \ -d '{ "prompt": "string", "model": "meta-llama/Llama-2-70b-hf" }'{ "id": "string", "choices": [ { "text": "string", "seed": 0, "finish_reason": "stop", "logprobs": { "token_ids": [ 0 ], "tokens": [ "string" ], "token_logprobs": [ 0 ], "top_logprobs": { "property1": 0, "property2": 0 } } } ], "prompt": [ { "text": "string", "logprobs": { "token_ids": [ 0 ], "tokens": [ "string" ], "token_logprobs": [ 0 ], "top_logprobs": { "property1": 0, "property2": 0 } } } ], "usage": { "prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 0 }, "created": 0, "model": "string", "object": "text.completion"}Create chat completion POST
Generate a model response for a given chat conversation. Supports single queries and multi-turn conversations with system, user, and assistant messages.
Create embedding POST
Generate vector embeddings for one or more text inputs. Returns numerical arrays representing semantic meaning, useful for search, classification, and retrieval.