docs: finalize labeling models

This commit is contained in:
hieu-jan 2023-11-28 05:57:13 +09:00
parent 553fcae681
commit a2a0c38144
2 changed files with 70 additions and 39 deletions

View File

@ -52,8 +52,12 @@ paths:
tags: tags:
- Models - Models
summary: List Models summary: List models
description: Lists the currently available models, and provides basic information about each one such as the owner and availability. description: |
<a href = "https://platform.openai.com/docs/api-reference/models/list"> <button style = "color: #388434"> OpenAI Compatible </button></a>
Lists the currently available models, and provides basic information about each one such as the owner and availability.
responses: responses:
"200": "200":
description: OK description: OK
@ -69,8 +73,11 @@ paths:
operationId: downloadModel operationId: downloadModel
tags: tags:
- Models - Models
summary: Download Model summary: Download model
description: Download a model. description: |
<span style = "color: #fec928"> Jan </span>
Download a model.
responses: responses:
"200": "200":
description: OK description: OK
@ -84,20 +91,26 @@ paths:
curl -X POST https://localhost:1337/v1/models curl -X POST https://localhost:1337/v1/models
/models/{model_id}: /models/{model_id}:
get: get:
operationId: getModel operationId: retrieveModel
tags: tags:
- Models - Models
summary: Get Model summary: Retrieve model
description: Get a model instance, providing basic information about the model such as the owner and permissioning. description: |
<a href = "https://platform.openai.com/docs/api-reference/models/retrieve"> <button style = "color: #388434"> OpenAI Compatible </button></a>
Get a model instance, providing basic information about the model such as the owner and permissioning.
parameters: parameters:
- in: path - in: path
name: source_url name: model_id
required: true required: true
schema: schema:
type: string type: string
# ideally this will be an actual ID, so this will always work from browser # ideally this will be an actual ID, so this will always work from browser
example: https://huggingface.com/thebloke/example.gguf example: zephyr-7b
description: The ID of the model to use for this request description: |
The ID of the model to use for this request
<span style="color:#388434">OpenAI compatible</span>
responses: responses:
"200": "200":
description: OK description: OK
@ -113,8 +126,11 @@ paths:
operationId: deleteModel operationId: deleteModel
tags: tags:
- Models - Models
summary: Delete Model summary: Delete model
description: Delete a model. description: |
<a href = "https://platform.openai.com/docs/api-reference/models/delete"> <button style = "color: #388434"> OpenAI Compatible </button></a>
Delete a model.
parameters: parameters:
- in: path - in: path
name: model name: model
@ -122,7 +138,10 @@ paths:
schema: schema:
type: string type: string
example: zephyr-7b example: zephyr-7b
description: The model to delete description: |
The model to delete
<span style="color:#388434">OpenAI compatible</span>
responses: responses:
"200": "200":
description: OK description: OK
@ -139,8 +158,11 @@ paths:
operationId: startModel operationId: startModel
tags: tags:
- Models - Models
summary: Start Model summary: Start model
description: Starts an imported model. Loads the model into V/RAM. description: |
<span style = "color: #fec928"> Jan </span>
Starts an imported model. Loads the model into V/RAM.
parameters: parameters:
- in: path - in: path
name: model name: model
@ -149,7 +171,8 @@ paths:
type: string type: string
# ideally this will be an actual ID, so this will always work from browser # ideally this will be an actual ID, so this will always work from browser
example: zephyr-7b example: zephyr-7b
description: The ID of the model to use for this request description: |
The ID of the model to use for this request
responses: responses:
"200": "200":
description: OK description: OK
@ -166,8 +189,11 @@ paths:
operationId: stopModel operationId: stopModel
tags: tags:
- Models - Models
summary: Stop Model summary: Stop model
description: Stop an imported model. description: |
<span style = "color: #fec928"> Jan </span>
Stop an imported model.
parameters: parameters:
- in: path - in: path
name: model name: model
@ -437,7 +463,7 @@ paths:
operationId: listMessages operationId: listMessages
tags: tags:
- Messages - Messages
summary: List messaages summary: List messages
description: Retrieves all messages from the given thread. description: Retrieves all messages from the given thread.
parameters: parameters:
- in: path - in: path
@ -564,7 +590,7 @@ paths:
'read:pets': read your pets 'read:pets': read your pets
description: | description: |
<a href = "https://platform.openai.com/docs/api-reference/messages/listMessages"> <button style = "color: #388434"> OpenAI Compatible </button></a> <a href = "https://platform.openai.com/docs/api-reference/messages/listMessages"> <button style = "color: #388434"> OpenAI Compatible </button></a>
<a href = "https://platform.openai.com/docs/api-reference/messages/listMessages"> <button style = "color: #fec928">Jan.AI Compatible </button></a> <a href = "https://platform.openai.com/docs/api-reference/messages/listMessages"> <button style = "color: #fec928"> Jan </button></a>
Returns a list of message files. Returns a list of message files.
@ -588,7 +614,7 @@ paths:
description: | description: |
The ID of the message whose files are to be listed. The ID of the message whose files are to be listed.
<span style="color:#388434">Open.AI Compatible</span> <span style="color:#388434">OpenAI compatible</span>
responses: responses:
"200": "200":
description: List of files retrieved successfully description: List of files retrieved successfully
@ -648,7 +674,12 @@ x-webhooks:
ModelObject: ModelObject:
post: post:
summary: The model object summary: The model object
description: Information about a model in the systems description: |
<a href = "https://platform.openai.com/docs/api-reference/models/object"> <button style = "color: #388434"> OpenAI Compatible </button></a>
Describe a model offering that can be used with the API.
operationId: ModelObject operationId: ModelObject
tags: tags:
- Models - Models

View File

@ -117,26 +117,33 @@ components:
properties: properties:
id: id:
type: string type: string
description: "The identifier of the model." description: |
"The identifier of the model."
<span style="color:#388434">OpenAI compatible</span>
example: "zephyr-7b" example: "zephyr-7b"
object: object:
type: string type: string
description: "The type of the object, indicating it's a model." description: |
"The type of the object, indicating it's a model."
<span style="color:#388434">OpenAI compatible</span>
default: "model" default: "model"
created: created:
type: integer type: integer
format: int64 format: int64
description: "Unix timestamp representing the creation time of the model." description: |
"Unix timestamp representing the creation time of the model."
<span style="color:#388434">OpenAI compatible</span>
example: "1253935178" example: "1253935178"
owned_by: owned_by:
type: string type: string
description: "The entity that owns the model." description: |
"The entity that owns the model."
<span style="color:#388434">OpenAI compatible</span>
example: "_" example: "_"
required:
- id
- object
- created
- owned_by
GetModelResponse: GetModelResponse:
type: object type: object
@ -253,10 +260,7 @@ components:
type: boolean type: boolean
description: "Indicates whether the model was successfully deleted." description: "Indicates whether the model was successfully deleted."
example: true example: true
required:
- id
- object
- deleted
StartModelResponse: StartModelResponse:
type: object type: object
@ -313,8 +317,4 @@ components:
type: string type: string
description: "The current state of the model after the start operation." description: "The current state of the model after the start operation."
example: "downloaded" example: "downloaded"
required:
- id
- object
- state