---
title: "POST /model-hub/experiments/v2/"
method: POST
path: "/model-hub/experiments/v2/"
tags: ["model-hub"]
---

# POST /model-hub/experiments/v2/

`POST /model-hub/experiments/v2/`

## Request

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

## Request body

- ExperimentCreateV2
  - `name` string, required
  - `dataset_id` string, uuid, required
  - `column_id` string, uuid, nullable
  - `experiment_type` 'llm' | 'tts' | 'stt' | 'image'
  - `prompt_config` PromptConfigEntry[], required
    - `id` string, uuid, nullable
    - `name` string
    - `prompt_id` string, uuid, nullable
    - `prompt_version` string, uuid, nullable
    - `agent_id` string, uuid, nullable
    - `agent_version` string, uuid, nullable
    - `model` object: String or JSON object.
    - `model_params` PromptModelParams
      - `temperature` number
      - `max_tokens` integer
      - `top_p` number
      - `frequency_penalty` number
      - `presence_penalty` number
      - `response_format` object: String or JSON object.
    - `configuration` PromptConfiguration
      - `tool_choice` string
      - `template_format` string
      - `tools` object[]
      - `output_format` string
      - `model_type` string
      - `model_detail` object: Any valid JSON value.
      - `voice_id` string
    - `output_format` string
    - `messages` MessageItem[]
      - `role` string, required
      - `content` object, required: Plain text string or array of content-part objects.
      - `name` string
      - `tool_calls` object: Any valid JSON value.
      - `tool_call_id` string
      - `id` string
    - `voice_input_column_id` string, uuid, nullable
  - `user_eval_metrics` EvalMetricEntry[], required
    - `id` string, uuid, nullable
    - `template_id` string, uuid, required
    - `name` string, required
    - `config` object, required
    - `model` string
    - `error_localizer` boolean
    - `kb_id` string, uuid, nullable
    - `composite_weight_overrides` object, nullable

## Response `200`

OK

- ExperimentStringResultResponse
  - `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)