Text Generation API Reference

Following are the steps to use Test it feature.

• Replace the {{url}} with the deployed url.

• Get the api key from the GenAI Stack for authentication.

• Now you're ready to test the APIs.

Health

GET{{url}}/health

Response

200

Successful Response

Body

application/json

any

Request

JavaScriptCurlPython

const response = await fetch('{{url}}/health', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get Stack App

Retrieve the stack app instance.

This endpoint fetches the stack app, including its associated chat sessions or text generations based on the interface type selected, using the provided token/api key.

Parameters:

• authorization: str - Provide your API key as a Bearer token in the Authorization header to authenticate requests.

Responses:

• 200 OK: Returns a detailed view of the stack app including chat sessions and text generations.
• 404 Not Found: If no stack app is found for the given criteria.

Exceptions:

• Raises a 404 HTTPException if no stack app is found.

GET{{url}}/api/v1/apps

Query parameters

Header parameters

Response

200422

Successful Response

Body

application/json

id*Id

data*Data

form_keys_data*Form Keys Data

stack_type*StackAppType

chattext_generation

chat_sessions*Chat Sessions

array of ChatSessionReadnull

text_generations*Text Generations

array of TextGenerationReadnull

Request

JavaScriptCurlPython

const response = await fetch('{{url}}/api/v1/apps', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200422

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "stack_type": "chat",
  "chat_sessions": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "data": [
        {
          "is_bot": true,
          "message": "text",
          "chatKey": "text",
          "type": "text",
          "intermediate_steps": "text",
          "files": []
        }
      ]
    }
  ],
  "text_generations": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "logs": "text",
      "status": "pending"
    }
  ]
}

List Text Generations

Retrieves a list of text generations created by the authenticated user, ordered by creation date in descending order.

Parameters:

• authorization: str - Provide your API key as a Bearer token in the Authorization header to authenticate requests.

Responses:

• 200 OK: Returns a list of TextGenerationRead objects, each representing a text generation instance.
• 401 Unauthorized: User authentication failed.

Exceptions:

• Raises 401 HTTPException for unauthorized access.

This endpoint allows users to view all their text generation activities within the system, providing a comprehensive history of generated texts.

GET{{url}}/api/v1/generations

Query parameters

Header parameters

Response

200422

Successful Response

Body

application/json

id*Id

title*Title

inputs*Inputs

objectnull

outputs*Outputs

objectnull

logs*Logs

stringnull

meta_data*Meta Data

objectnull

status*TextGenerationStatus

pendingprocessingcompletedfailed

Request

JavaScriptCurlPython

const response = await fetch('{{url}}/api/v1/generations', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200422

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "text",
    "logs": "text",
    "status": "pending"
  }
]

Create Text Generation

Creates a new text generation request based on the input provided and associates it with the authenticated user.

Parameters:

• request: Request - The request object, allowing access to the request body.
• authorization: str - Provide your API key as a Bearer token in the Authorization header to authenticate requests.

Request Body: The body should contain form data representing the inputs for text generation. form data should be a list of dict(s).

• input_key: str - A key for identifying a input or the specific pipeline this upload is associated with.
• input_value: str | UploadFile - A resource to be associated with the input_key for Text Generation session.

Responses:

• 200 OK: Successfully creates a new text generation instance and returns its details as a TextGenerationRead object.
• 401 Unauthorized: User authentication failed.

Exceptions:

• Raises 401 HTTPException for unauthorized access.

Upon successful creation, this endpoint asynchronously triggers the text generation process and returns the created instance's details without waiting for the generation to complete.

POST{{url}}/api/v1/generations

Query parameters

Header parameters

Response

200422

Successful Response

Body

application/json

id*Id

title*Title

inputs*Inputs

objectnull

outputs*Outputs

objectnull

logs*Logs

stringnull

meta_data*Meta Data

objectnull

status*TextGenerationStatus

pendingprocessingcompletedfailed

Request

JavaScriptCurlPython

const response = await fetch('{{url}}/api/v1/generations', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200422

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "logs": "text",
  "status": "pending"
}

Read Text Generation

Retrieves the details of a specific text generation instance by its ID, for the authenticated user.

Parameters:

• text_gen_id: str - The unique identifier of the text generation instance to retrieve.
• authorization: str - Provide your API key as a Bearer token in the Authorization header to authenticate requests.

Responses:

• 200 OK: Returns the details of the specified text generation instance as a TextGenerationRead object.
• 400 Bad Request: If the text_gen_id is not a valid UUID.
• 401 Unauthorized: User authentication failed.
• 404 Not Found: If no text generation instance is found matching the text_gen_id for the authenticated user.

This endpoint allows users to access detailed information about a specific text generation activity, including its inputs and any generated outputs.

GET{{url}}/api/v1/generations/{text_gen_id}

Path parameters

text_gen_id*Text Gen Id

Query parameters

Header parameters

Response

200422

Successful Response

Body

application/json

id*Id

title*Title

inputs*Inputs

objectnull

outputs*Outputs

objectnull

logs*Logs

stringnull

meta_data*Meta Data

objectnull

status*TextGenerationStatus

pendingprocessingcompletedfailed

Request

JavaScriptCurlPython

const response = await fetch('{{url}}/api/v1/generations/{text_gen_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200422

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "logs": "text",
  "status": "pending"
}

Update Text Generation

Updates the title of a text generation session.

Parameters:

• TextGenerationUpdate - The request body containing the title to be updated.
• text_gen_id: str - The unique identifier of the text generation instance to retrieve.
• authorization: str - Provide your API key as a Bearer token in the Authorization header to authenticate requests.

Responses:

• 200 OK: Returns the details of the specified text generation instance as a TextGenerationRead object after updating it.
• 400 Bad Request: If the text_gen_id is not a valid UUID.
• 401 Unauthorized: User authentication failed.
• 404 Not Found: If no text generation instance is found matching the text_gen_id for the authenticated user.

This endpoint allows users to update the title of text generation session.

PATCH{{url}}/api/v1/generations/{text_gen_id}

Path parameters

text_gen_id*Text Gen Id

Query parameters

Header parameters

Body

application/json

titleTitle

stringnull

Response

200422

Successful Response

Body

application/json

id*Id

title*Title

inputs*Inputs

objectnull

outputs*Outputs

objectnull

logs*Logs

stringnull

meta_data*Meta Data

objectnull

status*TextGenerationStatus

pendingprocessingcompletedfailed

Request

JavaScriptCurlPython

const response = await fetch('{{url}}/api/v1/generations/{text_gen_id}', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200422

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "logs": "text",
  "status": "pending"
}