Skip to main content
POST
Prompt run request
See the Running prompts guide for the full flow (prepare prompts → submit → poll → retrieve answers) and polling loop code.

FAQ

Where do I get the results after submitting? Poll Get run status with the returned runID, and once it is FINISHED, query List answers with the runID filter.

Authorizations

API-Key
string
header
required

"Enter your organization API key. Example: 'cs_live_xxxx'"

Body

application/json

Prompt run request

models
enum<string>[]
required

List of models to run. Only values retrievable from GET /models are allowed. Discontinued models are rejected with 400 MODEL_DISCONTINUED before validation, so they are not kept in the oneof list (none at present)

Required array length: 1 - 13 elements
Available options:
CHATGPT,
GOOGLE_OVERVIEW,
GOOGLE_AI,
PERPLEXITY,
GEMINI,
NAVER_AI_BRIEFING,
NAVER_AI_TAB,
CLAUDE,
META_MUSE,
BAIDU_AI_SEARCH,
GROK,
BAIDU_AI_TAB,
DEEPSEEK
Example:
location
string

Run location (city-level, below the country). If omitted, the run uses the region (country) level. Only codes retrievable from GET /locations are allowed, and if region is also specified, the location must belong to that region. If region is omitted, the run uses the location's region. Every requested model must support this location (check with GET /locations?model=).

Example:

"US-NEW_YORK"

promptIDs
string[]

List of prompt IDs to run (1 to 500, duplicates count once). Specify exactly one of this or promptSetID

Required array length: 1 - 500 elements
Example:
promptSetID
string

ID of the prompt set to run: runs every prompt in the set. Specify exactly one of this and promptIDs. There is no 500-prompt limit on the set size; only the total run limit (10,000) applies

Example:

"IkVMHhjFWcBXcJ41-h9yBQ"

region
string

Run region (ISO 3166-1 alpha-2). Defaults to KR when omitted. Unsupported codes return 400. Supported regions may differ by model (check with GET /regions?model=)

Example:

"KR"

repeatCount
integer

Number of repeated runs per prompt (question) (default 1, max 100).

Required range: 1 <= x <= 100
Example:

1

Response

OK

id
string

ID of the created prompt run. Pass this value as is as the runID of the run status endpoint (GET /v1/platform/runs/{runID})

Example:

"S8cqDSjSot67bCK6YtmvHw"