get_task_format
Task YAML format
How to write an OpenMark task: the YAML structure, all 18 scoring modes, and tips. Call this before writing a task. Pass a topic for the full detail on one subject (the app's Task Guide): fields, scoring, composite, chaining, documents, examples, best_practices, or a scoring mode name.
Parameterstopic
validate_task
Check a task
Check a task YAML the way OpenMark will before running it: structure, scoring settings, and the test limit of the user's plan. Free, saves nothing. Returns the problems to fix and warnings worth a look.
Parameterstask_yamlrequired
Current OpenMark model ids with list prices ($ per 1M tokens), as text and as a structured list. Use these ids in run_benchmark. Append @low, @medium or @high to a reasoning model id to set its reasoning effort.
Parameterssearchimages_onlymax_output_price
prepare_attachments
Prepare file attachments
Get an upload_uid and a one-hour upload link (no API key needed) for images, PDFs or text documents, with the exact curl command. Upload the files, reference them by file name in each test's attachments list, then pass the upload_uid to estimate_cost / run_benchmark.
Parametersfile_names
estimate_cost
Estimate a run's cost
Credits a run_benchmark call would use, before spending anything: the expected total, the split per model, the balance needed to start, the worst case, and the user's balance. Same inputs and run settings as run_benchmark. Use it to drop an expensive model, or to compare settings (e.g. max_tokens), before running.
Parametersmodelsrequiredpresetfail_fasttask_yamlrequiredmax_tokensupload_uidcustom_timeoutstability_runstemp_preferencetimeout_profiletemperature_discovery
run_benchmark
Run a benchmark
Save a task (YAML, see get_task_format) to the user's OpenMark account and run it on the given models with real API calls. Returns a job_id and the expected cost; poll get_results. Spends the user's credits; pass max_credits to only start within a budget. Optional run settings match the app's Configure & Run panel (preset, stability_runs, max_tokens, temperature_discovery, temp_preference, timeout_profile, custom_timeout, fail_fast).
Parametersmodelsrequiredpresetfail_fasttask_yamlrequiredmax_tokensupload_uidmax_creditscustom_timeoutstability_runstemp_preferencetimeout_profiletemperature_discovery
get_results
Get benchmark results
Status of a benchmark job, and once completed the ranked results (score, stability, cost per run, latency), the tests each model missed with its answer, a recommendation for the chosen objective and quick picks for the others.
Parametersjob_idrequiredtoleranceshow_missesoptimize_for
get_account
Account, credits and plans
The user's plan, credit balance and limits, and what a credit pack, Pro or Expert would unlock. Use it before large runs, or when a run is refused for credits or limits.
Takes no parameters.
watch_task
Watch a task for better models
Watch the task of a completed job: when new or cheaper models ship, OpenMark re-tests up to 4 of them next to the user's pick and emails the user only when one beats it. Each check uses the user's credits at the normal rate.
Parametersmodeljob_idrequired