---
title: "POST /model-hub/develops/preview_run_prompt_column/"
method: POST
path: "/model-hub/develops/preview_run_prompt_column/"
tags: ["model-hub"]
---

# POST /model-hub/develops/preview_run_prompt_column/

`POST /model-hub/develops/preview_run_prompt_column/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/model-hub/develops/preview_run_prompt_column/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

## Request body

- PreviewRunPrompt
  - `dataset_id` string, uuid, required
  - `name` string, required
  - `config` PromptConfig
    - `model` string
    - `run_prompt_config` object
    - `messages` object[]: List of messages with format [{'role': 'user/assistant', 'content': 'text'}]
    - `temperature` number, nullable: Controls the randomness. Value between 0 and 2.
    - `frequency_penalty` number, nullable: Penalty for word repetition. Value between -2 and 2.
    - `presence_penalty` number, nullable: Penalty for new word usage. Value between -2 and 2.
    - `max_tokens` integer, nullable: Maximum number of tokens to generate. Null = use provider default.
    - `top_p` number, nullable: Controls diversity via nucleus sampling. Value between 0 and 1.
    - `response_format` object, nullable: String or JSON object.
    - `tool_choice` 'auto' | 'required' | 'null', nullable: Tool selection mode: 'auto' or 'required'.
    - `tools` object[], nullable: List of tools with tool properties if available.
    - `output_format` 'array' | 'string' | 'number' | 'object' | 'audio' | 'image', nullable: Output format type.
    - `concurrency` integer, nullable: Number of concurrent operations allowed. Maximum 10.
  - `first_n_rows` integer
  - `row_indices` integer[]: List of row indices to preview. Must contain at least one integer.

## Response `200`

OK

- RunPromptColumnPreviewResponse
  - `status` boolean, required
  - `result` RunPromptColumnPreviewResult, required
    - `responses` object[], required
    - `token_usage` object, required
    - `cost` object, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)