---
title: "Optimizer Create Run"
method: POST
path: "/v1/developer/{developer_id}/optimizer/runs"
tags: ["SoL Optimizer"]
---

# Optimizer Create Run

`POST /v1/developer/{developer_id}/optimizer/runs`

## Request

- Base URL: `https://api.oneinfer.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.oneinfer.ai/v1/developer/{developer_id}/optimizer/runs`
- Auth: HTTP bearer

## Path parameters

- `developer_id` string, required

## Request body

- OptimizerRunCreateRequest
  - `name` string, nullable
  - `agent_model` string, required
  - `agent_effort` 'medium' | 'high' | 'xhigh' | 'max'
  - `model_id` string, required
  - `revision` string
  - `gpu_count` integer
  - `max_model_len` integer, nullable
  - `instance_id` string, nullable
  - `sandbox_offer_id` string, nullable
  - `simulated_gpu` string, nullable
  - `workload_agent_id` string, nullable
  - `objective` 'throughput' | 'latency' | 'goodput'
  - `slo` object
  - `scenarios` OptimizerScenario[], required
    - `key` string, required
    - `label` string, required
    - `concurrency` integer, required
    - `prompt_tokens` integer, required
    - `output_tokens` integer, required
    - `num_requests` integer, nullable
    - `shared_prefix_tokens` integer
    - `primary` boolean
  - `precision` object
  - `levers` object
  - `budget` object
  - `baselines` string[]
  - `sol_target_pct` number
  - `min_gain_pct` number
  - `regression_tolerance_pct` number
  - `latency_tolerance_pct` number, nullable
  - `tracks` OptimizerTrack[]
    - `key` string, required
    - `label` string, required
    - `scenarios` string[], required
  - `hf_token` string, password, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oneinfer/apis/oneinfer-apis.md) · [All operations](https://skmtc.dev/oneinfer/apis/oneinfer-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/oneinfer/apis/oneinfer-apis/revisions/a49f22311a8f?raw)