Refine a prompt version

POST

Refine a prompt version using a teacher model and save the refined prompt as a new version.

prompt_idintegerRequired

Prompt ID

version_idintegerRequired

Base Prompt Version ID

asyncbooleanOptional

Run the refinement job asynchronously

This endpoint expects an object.

teacher_model_provider_connection_idintegerOptional

Model Provider Connection ID to use to refine the prompt

teacher_model_namestringOptional

Name of the model to use to refine the prompt

project_idintegerOptional

Project ID to target the refined prompt for

promptstring

The refined prompt text

titlestringOptional

Title of the refined prompt

reasoningstringOptional

Reasoning behind the refinement

refinement_job_idstringOptional

Unique identifier for the refinement job

refinement_statusenumOptionalDefaults to Pending

Status of the refinement job

Allowed values:

total_coststringOptional

Total cost of the refinement job (in USD)

previous_versionobjectOptional

Previous version of the prompt

1	from label_studio_sdk import LabelStudio
2
3	client = LabelStudio(
4	api_key="YOUR_API_KEY",
5	)
6	client.prompts.versions.refine_prompt(
7	prompt_id=1,
8	version_id=1,
9	)

1	{
2	"prompt": "prompt",
3	"title": "title",
4	"reasoning": "reasoning",
5	"refinement_job_id": "refinement_job_id",
6	"refinement_status": "Pending",
7	"total_cost": "total_cost",
8	"previous_version": {
9	"title": "title",
10	"parent_model": 1,
11	"model_provider_connection": 1,
12	"prompt": "prompt",
13	"provider": "OpenAI",
14	"provider_model_id": "provider_model_id",
15	"created_by": 1,
16	"created_at": "2024-01-15T09:30:00Z",
17	"updated_at": "2024-01-15T09:30:00Z",
18	"organization": 1
19	}
20	}