Reflet

reflet:image

Generate a still image from a text prompt. Waits for the result (~10-30s) and returns the image URL plus a thumbnail you can look at. Optional: a specific model (see the models tool), an aspect ratio, and references: image URLs, asset ids, or element names from your memory (see the elements tool). Editing = generating with a reference.

“a red bicycle against a white wall, photo”

reflet:video

Generate a video from a text prompt (async, typically 1-5 minutes). Returns a request_id immediately - poll it with the status tool. Optional: model, aspect_ratio, and start_image (URL or asset id) for image-to-video.

reflet:status

Check a generation by request_id. Returns the final asset (with thumbnail) when done.

{
  "status": "completed",
  "asset_id": "b3xQ…",
  "model": "kling-3",
  "url": "https://storage.googleapis.com/…/video.mp4"
}

reflet:models

The curated model catalog: cost in credits, strengths, and when to pick each one.

{
  "status": "ok",
  "models": [
    {
      "name": "gpt-image-2",
      "category": "image",
      "cost": 10
    },
    {
      "name": "nano-banana",
      "category": "image",
      "cost": 12
    },
    {
      "name": "kling-3",
      "category": "video",
      "cost": 33
    }
  ]
}

reflet:balance

Your credit balance, and roughly how many images that buys.

{
  "status": "ok",
  "team": "Acme",
  "balance": 1240,
  "approx_images": 310
}

reflet:save

Save a reusable element to your team's creative memory: a person, product, place, or style with reference images. Once saved, use its name in the references of image/video to keep it consistent across generations. The magic move after a good generation: save the character.

{
  "status": "saved",
  "element": {
    "slug": "lea",
    "name": "Lea",
    "kind": "person",
    "description": "red-haired woman in her thirties, green jacket"
  }
}

reflet:elements

List your team's creative memory: saved people, products, places and styles, with their descriptions. Read this to know what names like "Lea" mean before using them in image/video references.

{
  "status": "ok",
  "elements": [
    {
      "slug": "lea",
      "kind": "person",
      "used_in_generations": 14
    },
    {
      "slug": "flagshipbottle",
      "kind": "product",
      "used_in_generations": 9
    }
  ]
}

reflet:assets

Search your team's past generations: by prompt text, type, or element used. "The April campaign visual" becomes findable again. Returns asset ids you can reuse as references.

{
  "status": "ok",
  "count": 2,
  "assets": [
    {
      "asset_id": "b3xQ…",
      "prompt": "April campaign hero visual…",
      "elements": [
        "lea"
      ]
    }
  ]
}