Request and Responses

Keys

Understand the structure of JSON request bodies and responses, including key details for success, tokens, and identifiers.

Request and Response Formats

Api Key

Wetrocloud

Welcome 👋 to the Wetrocloud Developer Documentation. Here you'll learn how to easily integrate Retrieval Augmented Generation (RAG) into your applications using the Wetrocloud API.

Introduction

To get started with Wetrocloud’s API, follow these steps to create your API key

How to Access Your API Key

Learn how to create collections, insert resources, and query them using cURL in just a few minutes.

Quickstart

Learn how to use our API keys to develop products using OpenAI SDK

OpenAI Compatibility

WetroCloud currently supports the following models:

Supported Models

Learn how to create collections using the Wetrocloud API

Create a Collection

This API endpoint displays a list of all your existing collections.

List collections

Learn how to insert resources using the Wetrocloud API

Insert a Resource

Learn how to query your collections in WetroCloud for both free text and structured responses.

Query your Resources

Learn how to query resources using the Wetrocloud API

Structured Output

Learn how to classify and structure resources using WetroCloud.

Data categorization

Learn how to delete a collection using the Wetrocloud API when they are no longer needed.

Delete a Collection

Learn how to generate free text responses using the Wetrocloud API.

Text Generation (Without RAG)

Learn how to query images in WetroCloud to retrieve information, descriptions, or answers based on the image using the WetroCloud APIs image-to-text endpoint.

Image to text (OCR)

Learn how to extract content from websites using the WetroCloud scrape endpoint.

Data extraction

Token optimization

Learn how to easily integrate Retrieval Augmented Generation (RAG) into your applications.

Learn about the resources wetrocloud API supports

Supported Resource Types

Explore the available WetroCloud API endpoints for creating, inserting, querying, and categorizing resources, with detailed response formats.

API Endpoints

This endpoint allows you to create a new collection_id.

#### Request Body

- No request body parameters required.
    

#### Response

The response will be a JSON object with the following properties:

- `collection_id` (string): The ID of the created item.
    
- `success` (boolean): Indicates whether the item creation was successful.

Create Collection

This endpoint allows you to list all your existing collections.
<Note> This list has a pagination of up to <b>20</b> items per request. `Next` and `Previous` urls will be provided on every response </Note>
#### Request Body
- No request body parameters required.
    

#### Response

The response will be a JSON object with the following properties:

- `count` (number): Total number of collections. - `next` (string): URL for the next pagination item. - `previous` (string): URL for the previous pagination item. - `results` (list): A list of all available collections.

List all Collections


This endpoint allows you to add data to a collection using an HTTP POST request.

#### Request Body

- `collection_id` (text): The ID of the collection to which the data will be added.
    
- `resource` (text): The resource to be added to the collection.
    
- `type` (text): The type of the resource being added.
    

#### Response

Upon successful addition, the response will include:

- `success` (boolean): Indicates whether the operation was successful.
    
- `tokens` (number): The number of tokens generated.
    

Insert Resource

This endpoint allows the user to make an HTTP POST request to submit a query to the specified collection.

### Request Body

- `collection_id` (text): The ID of the collection to which the query is being submitted.
    
- `request_query` (text): The query being submitted to the collection.
    
- `json_schema` (text): The JSON schema for the query response.
    
- `json_schema_rules` (text): Rules for the JSON schema.
    

### Response

The response for this request is a JSON schema with the following structure:
- `response` (object): The JSON schema for the query response.
    
- `tokens` (number): The number of tokens.
    
- `success` (boolean): Indicates whether the request was successful.

Query Resource



This endpoint allows you to create a new category by providing the necessary details in the request body.

#### Request Body

- `resource` (text): Description of the resource.
    
- `type` (text): Type of the category.
    
- `json_schema` (text): JSON schema for the category.
    
- `json_schema_rules` (text): Rules for the JSON schema.
    

#### Response

The response is a JSON object with the following properties:

- `label`: The label of the response.
    
- `tokens`: The number of tokens.
    
- `success`: Indicates the success status of the request.
    

Categorize Resource

This endpoint is used to delete a collection.

#### Request Body

- `collection_id` (text) - The ID of the collection to be deleted.
    

#### Response

- `message` - A message indicating the result of the deletion.
    
- `success` - Indicates whether the deletion was successful.

Delete Collection



This endpoint allows you to retrieve specific data from  a web page in a structured JSON format based on your predefined schema.

#### Request Body

- `website` (text): Website url to be scraped.
    
- `json_schema` (text): JSON schema for the response.
    

#### Response

The response is a JSON object with the following properties:

- `response`: The JSON object structured as per the provided schema.
    
- `tokens`: The number of tokens.
    
- `success`: Indicates the success status of the request.
    



This endpoint allows you to analyze an image and  ask questions about its content 

#### Request Body

- `image_url` (text): Image url to be analyzed.
    
- `request_query` (text): Query been used to analyze image.
    

#### Response

The response is a JSON object with the following properties:

- `response`: The result of analysis.
    
- `tokens`: The number of tokens.
    
- `success`: Indicates the success status of the request.
    

Analyze Image



generate natural language responses using open source language models

#### Request Body

- `messages` (JSON): Array of messages.
    
- `model` (text): Identifier of language model to use (e.g., "llama-3.3-70b")
    

#### Response

The response is a JSON object with the following properties:

- `response`: Conversational response to the query.
    
- `tokens`: The number of tokens.
    
- `success`: Indicates the success status of the request.
    


success boolean	This lets you know if your request was succesful or not. We recommend that you use this in combination with HTTP status codes to determine the result of an API call
tokens integer	This provides the number of tokens used in processing your request. You can use this to monitor usage and manage limits effectively.
response string	This contains the main output or message from the API based on your request. It could be a generated answer, or error details.
collection_id string	This is the unique identifier for the collection being referenced or created. Use this to specify which collection you’re interacting with.

API Documentation

Endpoint Examples

Request and Response Formats

Request and Responses

Keys

API Documentation

Endpoint Examples

​Request and Responses

​Keys

Request and Responses

Keys