Keyword extraction use case

Headers

Authorization: Bearer ACCESS_TOKEN

string

The authentication and authorization access token.

Content-Type

string

application/json

Example:

"application/json"

Path Parameters

MODEL_ID

string

required

Unique identifier for the model.

Example:

"6a092bd4-5098-466c-94aa-40bf6829430\""

Body

application/json

batch

object[]

The batch of key:value pairs used as inputs in the prediction. Up to 32 inputs per request are allowed.

Maximum array length: 32

Show child attributes

batch.text

string

The content the model analyzes.

Example:

"Joseph Robinette Biden Jr.is an American politician who is the 46th and current president of the United States. Ideologically a moderate member of the Democratic Party, he previously served as the 47th vice president from 2009 to 2017 under President Barack Obama and represented Delaware in the United States Senate from 1973 to 2009.Born in Scranton, Pennsylvania, Biden moved with his family to Delaware in 1953. He studied at the University of Delaware before earning his law degree from Syracuse University. He was elected to the New Castle County Council in 1970 and to the U.S. Senate in 1972. As a senator, Biden drafted and led the effort to pass the Violent Crime Control and Law Enforcement Act and the Violence Against Women Act. He also oversaw six U.S. Supreme Court confirmation hearings, including the contentious hearings for Robert Bork and Clarence Thomas. Biden ran unsuccessfully for the Democratic presidential nomination in 1988 and 2008. In 2008, Obama chose Biden as his running mate, and Biden was a close counselor to Obama during his two terms as vice president. In the 2020 presidential election, Biden and his running mate, Kamala Harris, defeated incumbents Donald Trump and Mike Pence. Biden is the second Catholic president in U.S. history (after John F. Kennedy), and his politics have been widely described as profoundly influenced by Catholic social teaching."

useCaseConfig

UseCaseConfigKeywordExtraction · object

Show child attributes

useCaseConfig.maxKeywords

integer

This parameter specifies the maximum number of keywords that can be extracted, even though the model may contain more than the maximum number specified in this field.

Example:

100

modelConfig

ModelConfig · object

Provides fields and values that specify ranges for tokens. Fields used for specific use cases and models are specified. The default values are used if other values are not specified.

Show child attributes

modelConfig.temperature

number<float>

A sampling temperature between 0 and 2. A higher sampling temperature such as 0.8, results in more random (creative) output. A lower value such as 0.2 results in more focused (conservative) output. A lower value does not guarantee the model returns the same response for the same input. We recommend staying at or below a temperature of 1.0. Values above 1.0 might return nonsense unless the topP value is lowered to be more deterministic.

Required range: 0 <= x <= 2

Example:

0.8

modelConfig.topP

number<float>

A floating-point number between 0 and 1 that controls the cumulative probability of the top tokens to consider, known as the randomness of the LLM's response. This parameter is also referred to as top probability. Set topP to 1 to consider all tokens. A higher value specifies a higher probability threshold and selects tokens whose cumulative probability is greater than the threshold. The higher the value, the more diverse the output.

Required range: 0 <= x <= 1

Example:

1

modelConfig.topK

integer

An integer that controls the number of top tokens to consider. Set top_k to -1 to consider all tokens.

Example:

-1

modelConfig.presencePenalty

number<float>

A floating-point number between -2.0 and 2.0 that penalizes new tokens based on whether they have already appeared in the text. This increases the model's use of diverse tokens. A value greater than zero (0) encourages the model to use new tokens. A value less than zero (0) encourages the model to repeat existing tokens. This is applicable for all OpenAI, Mistral, and Llama models.

Required range: -2 <= x <= 2

Example:

2

modelConfig.frequencyPenalty

number<float>

A floating-point number between -2.0 and 2.0 that penalizes new tokens based on their frequency in the generated text. A value greater than zero (0) encourages the model to use new tokens. A value less than zero (0) encourages the model to repeat existing tokens. This is applicable for all OpenAI, Mistral, and Llama models.

Required range: -2 <= x <= 2

Example:

1

modelConfig.maxTokens

integer<int32>

The maximum number of tokens to generate per output sequence. The value is different for each model. Review individual model specifications when the value exceeds 2048.

Example:

1

modelConfig.apiKey

string

This optional parameter is only required when using the model for prediction. You can find this value in your model's settings:

OpenAI: Copy and paste the API key found in your organization's settings. For more information, see OpenAI Authentication API keys.
Azure OpenAI: Copy and paste the API key found in your Azure portal. See Authenticate with API key.
Anthropic: Copy and paste the API key found in your Anthrophic console or by using the Anthropic API.
Google Vertex AI: Copy and paste the base64-encoded service account key JSON found in your Google Cloud console. This service account key must have the Vertex AI user role enabled. For more information, see generate service account key.

Example:

"API key specific to use case and model"

modelConfig.azureDeployment

string

This optional parameter is the name of the deployed Azure OpenAI model and is only required when a deployed Azure OpenAI model is used for prediction.

Example:

"DEPLOYMENT_NAME"

modelConfig.azureEndpoint

string

This optional parameter is the URL endpoint of the deployed Azure OpenAI model and is only required when a deployed Azure OpenAI model is used for prediction.

Example:

"https://azure.endpoint.com"

modelConfig.googleProjectId

string

This parameter is optional, and is only required when a Google Vertex AI model is used for prediction.

Example:

"[GOOGLE_PROJECT_ID]"

modelConfig.googleRegion

string

This parameter is optional, and is only required when a Google Vertex AI model is used for prediction. The possible region values are:

us-central1
us-west4
northamerica-northeast1
us-east4
us-west1
asia-northeast3
asia-southeast1
asia-northeast

Example:

"[GOOGLE_PROJECT_REGION_OF_MODEL_ACCESS]"

Response

200 - application/json

predictions

object[]

Show child attributes

predictions.response

string

The results returned from the request.

Example:

"Joseph Robinette Biden Jr., 46th president of the United States, Democratic Party, Vice President, Barack Obama, Delaware, University of Delaware, Syracuse University, Violent Crime Control and Law Enforcement Act, Violence Against Women Act."

predictions.tokensUsed

object

Show child attributes

predictions.tokensUsed.promptTokens

integer<int32>

The number of tokens generated to prompt the model to continue generating results.

Example:

148

predictions.tokensUsed.completionTokens

integer<int32>

The number of tokens used until the model completes.

Example:

27

predictions.tokensUsed.totalTokens

integer<int32>

The sum of the prompt and completion tokens used in the model.

Example:

175

predictions.keywords

string[]

Keywords derived from the response. The number of keywords is limited to the maxKeywords field in the request.

"keywords": [
        "Joseph Robinette Biden Jr.",
        "46th president of the United States",
        "Democratic Party",
        "Vice President",
        "Barack Obama",
        "Delaware",
        "University of Delaware",
        "Syracuse University",
        "Violent Crime Control and Law Enforcement Act",
        "Violence Against Women Act"
      ]

Models

Authentication

Use Case

Predict

Async Chunking

Async Predict

Prompt Preview

Signals

Tokenization

Headers

Path Parameters

Body

Response