---
title: "POST /model-hub/run-prompt/"
method: POST
path: "/model-hub/run-prompt/"
tags: ["model-hub"]
---

# POST /model-hub/run-prompt/

`POST /model-hub/run-prompt/`

## Request

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

## Request body

- Litellm
  - `dataset_id` string, required
  - `model` string, required
  - `name` string, required
  - `concurrency` integer
  - `messages` object[], required: List of messages with format [{'role': 'user/assistant', 'content': 'text'}]
  - `output_format` 'array' | 'string' | 'number' | 'object' | 'audio' | 'image': Output format type. Defaults to 'string'.
  - `temperature` number, nullable: Controls the randomness. Value between 0 and 1.
  - `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: String or JSON object.
  - `tool_choice` string: Tool selection mode: 'auto' or 'required'.
  - `tools` object[]: List of tools with tool properties if available.

## Response `200`

OK

- ModelHubStringResultResponse
  - `status` boolean, required
  - `result` string, 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)