diff --git a/docs/openapi/jan.yaml b/docs/openapi/jan.yaml index cfaa06847..de01e271b 100644 --- a/docs/openapi/jan.yaml +++ b/docs/openapi/jan.yaml @@ -56,7 +56,7 @@ paths: - Chat summary: Create chat completion description: | - + and Jan specified Creates a model response for the given chat conversation. @@ -96,7 +96,7 @@ paths: summary: List models description: | - + Lists the currently available models, and provides basic information about each one such as the owner and availability. responses: @@ -137,7 +137,7 @@ paths: - Models summary: Retrieve model description: | - + Get a model instance, providing basic information about the model such as the owner and permissioning. parameters: @@ -151,7 +151,7 @@ paths: description: | The ID of the model to use for this request - OpenAI compatible + OpenAI compatible responses: "200": description: OK @@ -169,7 +169,7 @@ paths: - Models summary: Delete model description: | - + Delete a model. parameters: @@ -182,7 +182,7 @@ paths: description: | The model to delete - OpenAI compatible + OpenAI compatible responses: "200": description: OK @@ -264,7 +264,7 @@ paths: - Threads summary: Create thread description: | - + Create a thread requestBody: @@ -344,7 +344,7 @@ paths: - Threads summary: Retrieve thread description: | - + Retrieves detailed information about a specific thread using its thread_id. parameters: @@ -357,7 +357,7 @@ paths: description: | The ID of the thread to retrieve. - OpenAI compatible + OpenAI compatible responses: "200": description: Thread details retrieved successfully @@ -375,7 +375,7 @@ paths: - Threads summary: Modify thread description: | - + Modifies a thread parameters: @@ -388,7 +388,7 @@ paths: description: | The ID of the thread to be modified. - OpenAI compatible + OpenAI compatible requestBody: required: false content: @@ -430,7 +430,7 @@ paths: - Threads summary: Delete thread description: | - + Delete a thread parameters: @@ -443,7 +443,7 @@ paths: description: | The ID of the thread to be deleted. - OpenAI compatible + OpenAI compatible responses: "200": description: Thread deleted successfully @@ -506,7 +506,7 @@ paths: summary: List Thread.Messages description: | Jan - + Can achieve this goal by calling Get Thread API parameters: - in: path @@ -536,7 +536,7 @@ paths: - Messages summary: List messages description: | - + Retrieves all messages from the given thread. parameters: @@ -549,7 +549,7 @@ paths: description: | The ID of the thread from which to retrieve messages. - OpenAI compatible + OpenAI compatible responses: "200": description: List of messages retrieved successfully @@ -568,7 +568,7 @@ paths: - Messages summary: Create message description: | - + Create a message parameters: @@ -581,7 +581,7 @@ paths: description: | The ID of the thread to which the message will be posted. - OpenAI compatible + OpenAI compatible requestBody: required: true content: @@ -594,7 +594,7 @@ paths: description: | "Role of the sender, either 'user' or 'assistant'." - OpenAI compatible + OpenAI compatible example: "user" enum: ["user", "assistant"] content: @@ -602,7 +602,7 @@ paths: description: | "Text content of the message." - OpenAI compatible + OpenAI compatible example: "How does AI work? Explain it in simple terms." required: - role @@ -631,7 +631,7 @@ paths: - Messages summary: Retrieve message description: | - + Retrieve a specific message from a thread using its thread_id and message_id. parameters: @@ -644,7 +644,7 @@ paths: description: | The ID of the thread containing the message. - OpenAI compatible + OpenAI compatible - in: path name: message_id required: true @@ -654,7 +654,7 @@ paths: description: | The ID of the message to retrieve. - OpenAI compatible + OpenAI compatible responses: "200": description: OK @@ -675,7 +675,7 @@ paths: - Messages summary: List message files description: | - + Returns a list of message files. parameters: @@ -688,7 +688,7 @@ paths: description: | The ID of the thread containing the message. - OpenAI compatible + OpenAI compatible - in: path name: message_id required: true @@ -698,7 +698,7 @@ paths: description: | The ID of the message whose files are to be listed. - OpenAI compatible + OpenAI compatible responses: "200": description: List of files retrieved successfully @@ -719,7 +719,7 @@ paths: - Messages summary: Retrieve message file description: | - + Retrieves a file associated with a specific message in a thread. parameters: @@ -732,7 +732,7 @@ paths: description: | The ID of the thread containing the message. - OpenAI compatible + OpenAI compatible - in: path name: message_id required: true @@ -742,7 +742,7 @@ paths: description: | The ID of the message associated with the file. - OpenAI compatible + OpenAI compatible - in: path name: file_id required: true @@ -752,7 +752,7 @@ paths: description: | The ID of the file to retrieve. - OpenAI compatible + OpenAI compatible responses: "200": description: File retrieved successfully @@ -771,7 +771,7 @@ x-webhooks: post: summary: The model object description: | - + Describe a model offering that can be used with the API. @@ -789,7 +789,7 @@ x-webhooks: post: summary: The message object description: | - + Information about a message in the thread operationId: MessageObject @@ -805,7 +805,7 @@ x-webhooks: post: summary: The thread object description: | - and Jan + and Jan Each `thread` folder contains a `thread.json` file, which is a representation of a thread. diff --git a/docs/openapi/specs/chat.yaml b/docs/openapi/specs/chat.yaml index 7aef0cfe0..db738aee5 100644 --- a/docs/openapi/specs/chat.yaml +++ b/docs/openapi/specs/chat.yaml @@ -60,7 +60,7 @@ components: description: | Contains input data or prompts for the model to process - OpenAI compatible + OpenAI compatible example: [ { "content": "Hello there :wave:", "role": "assistant" }, @@ -72,42 +72,42 @@ components: description: | Specifies the model being used for inference or processing tasks - OpenAI compatible + OpenAI compatible stream: type: boolean default: true description: | Enables continuous output generation, allowing for streaming of model responses - OpenAI compatible + OpenAI compatible max_tokens: type: number default: 2048 description: | The maximum number of tokens the model will generate in a single response - OpenAI compatible + OpenAI compatible stop: type: arrays example: ["hello"] description: | Defines specific tokens or phrases at which the model will stop generating further output - OpenAI compatible + OpenAI compatible frequency_penalty: type: number default: 0 description: | Adjusts the likelihood of the model repeating words or phrases in its output - OpenAI compatible + OpenAI compatible presence_penalty: type: number default: 0 description: | Influences the generation of new and varied concepts in the model's output - OpenAI compatible + OpenAI compatible temperature: type: number default: 0.7 @@ -116,7 +116,7 @@ components: description: | Controls the randomness of the model's output - OpenAI compatible + OpenAI compatible top_p: type: number default: 0.95 @@ -125,7 +125,7 @@ components: description: | Set probability threshold for more relevant outputs - OpenAI compatible + OpenAI compatible ChatCompletionResponse: type: object diff --git a/docs/openapi/specs/messages.yaml b/docs/openapi/specs/messages.yaml index 97ff9ae4e..d4f61117e 100644 --- a/docs/openapi/specs/messages.yaml +++ b/docs/openapi/specs/messages.yaml @@ -8,14 +8,14 @@ components: description: | "Sequential or UUID identifier of the message." - OpenAI compatible + OpenAI compatible example: 0 object: type: string description: | "Type of the object, defaults to 'thread.message'." - OpenAI compatible + OpenAI compatible example: thread.message created_at: type: integer @@ -23,20 +23,20 @@ components: description: | "Unix timestamp representing the creation time of the message." - OpenAI compatible + OpenAI compatible thread_id: type: string description: | "Identifier of the thread to which this message belongs. Defaults to parent thread." - OpenAI compatible + OpenAI compatible example: "thread_asdf" assistant_id: type: string description: | "Identifier of the assistant involved in the message. Defaults to parent thread." - OpenAI compatible + OpenAI compatible example: jan role: type: string @@ -44,7 +44,7 @@ components: description: | "Role of the sender, either 'user' or 'assistant'." - OpenAI compatible + OpenAI compatible content: type: array items: @@ -55,7 +55,7 @@ components: description: | "Type of content, e.g., 'text'." - OpenAI compatible + OpenAI compatible text: type: object properties: @@ -64,7 +64,7 @@ components: description: | "Text content of the message." - OpenAI compatible + OpenAI compatible example: "Hi!?" annotations: type: array @@ -73,14 +73,14 @@ components: description: | "Annotations for the text content, if any." - OpenAI compatible + OpenAI compatible example: [] metadata: type: object description: | "Metadata associated with the message, defaults to an empty object." - OpenAI compatible + OpenAI compatible example: {} GetMessageResponse: diff --git a/docs/openapi/specs/models.yaml b/docs/openapi/specs/models.yaml index b4a5937b9..fdb9e1f9a 100644 --- a/docs/openapi/specs/models.yaml +++ b/docs/openapi/specs/models.yaml @@ -120,14 +120,14 @@ components: description: | "The identifier of the model." - OpenAI compatible + OpenAI compatible example: "zephyr-7b" object: type: string description: | "The type of the object, indicating it's a model." - OpenAI compatible + OpenAI compatible default: "model" created: type: integer @@ -135,14 +135,14 @@ components: description: | "Unix timestamp representing the creation time of the model." - OpenAI compatible + OpenAI compatible example: "1253935178" owned_by: type: string description: | "The entity that owns the model." - OpenAI compatible + OpenAI compatible example: "_" GetModelResponse: diff --git a/docs/openapi/specs/threads.yaml b/docs/openapi/specs/threads.yaml index f071d14a6..578e1ecdc 100644 --- a/docs/openapi/specs/threads.yaml +++ b/docs/openapi/specs/threads.yaml @@ -8,14 +8,14 @@ components: description: | "The identifier of the thread, defaults to foldername." - OpenAI compatible + OpenAI compatible example: thread_.... object: type: string description: | "Type of the object, defaults to thread." - OpenAI compatible + OpenAI compatible example: thread title: type: string @@ -63,14 +63,14 @@ components: description: | "Unix timestamp representing the creation time of the thread, defaults to file creation time." - OpenAI compatible + OpenAI compatible example: 1231231 metadata: type: object description: | "Metadata associated with the thread, defaults to an empty object." - OpenAI compatible + OpenAI compatible example: {} GetThreadResponse: @@ -135,14 +135,14 @@ components: description: | "Role of the sender, either 'user' or 'assistant'." - OpenAI compatible + OpenAI compatible enum: ["user", "assistant"] content: type: string description: | "Text content of the message." - OpenAI compatible + OpenAI compatible file_ids: type: array items: @@ -150,7 +150,7 @@ components: description: | "Array of file IDs associated with the message, if any." - OpenAI compatible + OpenAI compatible ModifyThreadResponse: type: object