Skip to main content
POST
Generate product configuration using AI

Authorizations

Authorization
string
header
required

API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....

Body

multipart/form-data
userDescription
string
required

A brief description of what the product does.

Minimum string length: 1
Example:

"A mobile sales assistant for smartphones."

productSpecs
file[]

Optional product specification files (documents, images, audio, video, code). Max 50 files, 10MB total.

productName
string | null

The name of the product.

Example:

"Mobile Sales Assistant"

useDetailedGeneration
string

Whether to use detailed generation mode (heavier model).

Example:

"true"

Response

Product configuration generated successfully

name
string
required

The AI-refined product name.

description
string
required

The AI-refined product description.

specifications
object[]
required

The generated testable specifications.

interactionMode
enum<string> | null
required

Suggested interaction mode, which the caller may keep or replace. Null when the classification was unavailable.

Available options:
CONVERSATIONAL,
HUMAN_DIRECT,
PROGRAMMATIC,
null
Example:

"CONVERSATIONAL"

primaryTask
enum<string> | null
required

Suggested primary task, which the caller may keep or replace. Null when the classification was unavailable.

Available options:
CONVERSATIONAL_ASSISTANCE,
QUESTION_ANSWERING_RAG,
DOCUMENT_EXTRACTION,
DOCUMENT_GENERATION,
SUMMARIZATION,
CLASSIFICATION,
TRANSLATION,
CORRECTION,
AGENTIC_WORKFLOW,
OTHER,
null
Example:

"QUESTION_ANSWERING_RAG"