livepair-hub

Keyword search over the community prompt library — tested AI image and video prompts with the results they produced. Use for style/subject/model lookups. For trending or most-used prompts call trending_prompts instead. Returns prompt text, model, result media, and a link to run it.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to look for — style, subject, or model name (e.g. 'cinematic portrait', 'anime pose')"
    },
    "kind": {
      "type": "string",
      "enum": [
        "image",
        "video",
        "agent"
      ],
      "description": "Optional media type filter"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Max results (default 8)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch one community prompt card by id — the verbatim prompt, model it ran on, the result media, like/view counts, and a studio link that preloads it.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Card id from search_prompts or trending_prompts"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use when the user asks for trending, most-used, most popular, or top prompts — do NOT keyword-search for these. Returns community prompt cards ranked by the paid generations they actually drove.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Max results (default 10)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Rewrite a rough prompt idea into the structured form our image models follow best (subject, composition, style, negatives). Use before generate_image — better input, better output.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The raw prompt idea to improve"
    },
    "mode": {
      "type": "string",
      "enum": [
        "t2i",
        "i2i",
        "t2v",
        "i2v"
      ],
      "description": "Target mode — pass the model's mode so the rewrite matches (default t2i)"
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Render an image or video with a catalog model (t2i, i2i, t2v, i2v) — including the private model line flagged private=true in list_models. This is a PAID call: the endpoint answers HTTP 402 with x402 payment requirements (USDC on Base mainnet — priced per call, video billed per second per model rate). Retry the request with a PAYMENT-SIGNATURE header settling one requirement — use an x402-capable client (@x402/fetch or equivalent). On success returns {status:'done',url}; slow jobs return a jobId to poll for free.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The prompt to render — call enhance_prompt first for best results"
    },
    "modelId": {
      "type": "string",
      "description": "Model id from list_models (default: fastest t2i)"
    },
    "image": {
      "type": "string",
      "description": "Source image for i2i/i2v models — public http(s) URL or data:image URI. Use AI-generated or owned images only — never real-person photos without consent"
    },
    "duration": {
      "type": "number",
      "description": "Video length in seconds (video models)"
    },
    "resolution": {
      "type": "string",
      "description": "Video resolution tier (video models)"
    },
    "payer": {
      "type": "string",
      "description": "Your 0x… wallet — applies your volume-tier discount; must equal the wallet signing the payment"
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Exact USDC price for a model+settings combo before paying — images are flat per call, video is per-second × duration at the resolution tier. The x402 endpoint always re-quotes from the body, so this is the same number it would charge.

{
  "type": "object",
  "properties": {
    "modelId": {
      "type": "string",
      "description": "Model id from list_models"
    },
    "duration": {
      "type": "number",
      "description": "Video seconds (video models)"
    },
    "resolution": {
      "type": "string",
      "description": "Video resolution tier"
    },
    "imageSize": {
      "type": "string",
      "description": "Image size label"
    },
    "aspectRatio": {
      "type": "string"
    },
    "payer": {
      "type": "string",
      "description": "Your 0x… payer wallet — applies your volume-tier discount"
    }
  },
  "required": [
    "modelId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check a running job returned by the paid generate endpoint — free. Returns {status:'done',url} | running | failed.

{
  "type": "object",
  "properties": {
    "jobId": {
      "type": "string",
      "description": "jobId returned by /v1/agent/generate"
    }
  },
  "required": [
    "jobId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Decide which model fits a need — returns the modelId to use with generate_image. Cheapest, fastest, or highest quality; for images or video; with or without a source image. Pass private:true to restrict to the private AI model line (i2v models).

{
  "type": "object",
  "properties": {
    "goal": {
      "type": "string",
      "enum": [
        "cheapest",
        "fastest",
        "best_quality"
      ],
      "description": "What to optimize for"
    },
    "media": {
      "type": "string",
      "enum": [
        "image",
        "video"
      ],
      "description": "Output type"
    },
    "hasSourceImage": {
      "type": "boolean",
      "description": "True when a source image drives the job (forces i2i/i2v)"
    },
    "private": {
      "type": "boolean",
      "description": "True to consider only the private AI model line"
    }
  },
  "required": [
    "goal",
    "media"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A themed bundle of curated prompt picks (themes: anime, portrait, landscape, product, character, sci-fi, fantasy, abstract, food, architecture). Curated packs are rebuilt daily and carry real paid-run counts — prompts that already produced paid results. Falls back to a live topic search when no pack covers the theme.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Topic tag, e.g. anime, product, portrait"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "topic"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the public image and video generation catalog — id, label, mode (text-to-image, image-to-video, etc), rough generation time, and private flag (private AI models — i2i/i2v source images must be AI-generated or owned, no real-person photos without consent).

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}