get_benchmark

Which model to use for a job, in three tiers (best, middle, cheapest), priced for this account: credits per reference request, who pays (paid_by: one of the user's own keys at no credits, the house's free allowance, or credits) and whether that payer can now (affordable), plus the account's two priorities (image_priority, clip_priority: best, balanced or cheapest) and, per task, the selected_tier its kind's priority picks. Call it before choosing a model and take the selected tier. When the priority for the kind is not saved, ask the user once, at their first request of that kind, what matters most (best quality, balanced or lowest cost, with the prices), save the answer with set_preferences and never ask again; until then an image takes the best tier and a clip (selected_tier null) waits for the answer. When a tier is not affordable, take the best affordable one and say so; a key that is out of funds (blocked) is the user's to top up, so ask. Pass task to also get the catalog recipes made for that job; when one fits, prefer it (generate_with_recipe, or start_recipe_run for a run recipe).

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_benchmark",
    "arguments": {}
  }
}

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "image",
        "video",
        "tts",
        "music"
      ]
    },
    "task": {
      "type": "string",
      "enum": [
        "photoreal-people",
        "same-person",
        "product-photos",
        "anime",
        "illustration",
        "text-in-images",
        "logos-vector",
        "photo-edits",
        "combine-pictures",
        "image-drafts",
        "clip-from-text",
        "animate-picture",
        "same-character-clips",
        "talking-head",
        "dialogue-and-sound",
        "cinematic-camera",
        "long-takes",
        "copy-a-movement",
        "lip-sync",
        "voice-over",
        "acted-voice",
        "other-languages",
        "songs",
        "background-music"
      ]
    }
  },
  "additionalProperties": false
}