score_files
Score files against the workspace's (and optionally a project's) output scoring rules.
Each rule is a studio's own standard — "does this read as our art direction?" — judged by a
vision model against the rule's prompt and reference images, returning 0-100 with a
rationale. Use list_output_scoring_rules to see what a scope asks; use get_file_scores to
read the verdicts back.
Asynchronous and billed: returns as soon as the run is queued, and every (file, rule) pair
is a model call that spends creative units. Poll get_file_scores for the results — a large
request takes a few minutes. Scoring the same file again is allowed and appends a fresh
verdict rather than replacing the old one.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
workspace_idrequired | string (uuid) | — | The workspace the files belong to. |
file_idsrequired | string (uuid)[] | — | The files to score, at most 100 per request. Generated outputs and uploads both qualify, as long as they are images, video or 3D. |
project_id | string (uuid) | — | Score under a project's policy as well as the workspace's. A project's rules are added to its workspace's, never replace them. |
rule_ids | string (uuid)[] | [] | Score against these rules only, from list_output_scoring_rules. Empty runs every rule in force for the scope. |