Placewise API

Generate Text

POST

https://api.mpc.dev.placewise.com/v1/ml/general/generate_text

API Permit:ML:TextGeneration:Post

API Context:Loyalty Club

Authorizations:User

Generates a text based on text prompt.

Body Parameters

Parameter	Type	Required?	Description
prompt	String	yes	Text generation prompt.
temperature	Float	no (default null)	Generation variability and creativity, in range [0, 1]. If null or higher than 0, results in nondeterministic generation.
max_tokens	Integer	no (default null)	Maximum number of tokens (~number of words) allowed in a generated text. If null, terminates when generative model thinks it should.

Example

When successful, returns:

{
    'text_generation_task': {
        'id': 1
    }
}

Request

Header Params

Content-Type

enum<string>

required

Details

Allowed value:

application/json

Default:

application/json

X-User-Agent

string

required

Arbitrary identifier of your client. Details

Default:

X-Product-Name

string

required

API Product for API context. Details

Default:

X-Loyalty-Club-Slug

string

required

LoyaltyClub for API context. Details

Default:

Authorization

string

required

Member or User Authorization.

Default:

Bearer {{_OAUTH_TOKEN}}

Body Params multipart/form-data

prompt

string

optional

Text generation prompt

Example:

Write a very short cheesecake recipe

temperature

number | null

optional

Generation variability and creativity, in range [0, 1]. If null or higher than 0, results in nondeterministic generation.

Example:

max_tokens

integer | null

optional

Maximum number of tokens (~number of words) allowed in a generated text. If null, terminates when generative model thinks it should.

Example:

1000

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.mpc.dev.placewise.com/v1/ml/general/generate_text' \
--header 'X-User-Agent;' \
--header 'X-Product-Name;' \
--header 'X-Loyalty-Club-Slug;' \
--header 'Authorization;' \
--form 'prompt="Write a very short cheesecake recipe"' \
--form 'temperature="0"' \
--form 'max_tokens="1000"'

Responses

🟢200Success

application/json

Body

text_generation_task

object

required

integer

required

Task ID

Example

{
    "text_generation_task": {
        "id": 0
    }
}

Modified at 2025-05-29 12:33:53

Generate Image

Generate Sending Text

Generate Text

Body Parameters#

Example#

Request

Request samples

Responses

Body Parameters

Example