Generate images

POST /image/generate creates an image task. Send a model id and a prompt. Everything else is optional.

import Mynth from "@mynthio/sdk";

const mynth = new Mynth();

const task = await mynth.image.generate({
  model: "black-forest-labs/flux.2-pro",
  prompt: "A lighthouse at dusk, film grain",
  size: "landscape",
});

console.log(task.urls[0]);

The SDK and the CLI wait and return the finished task. The REST call returns at once with a task id:

{
  "data": {
    "task_id": "tsk_01KE7XWWEQ4MCGWKBQKJ1G47RP",
    "estimated_cost": "0.03"
  }
}

Collect the result by polling or with a webhook.

Fields

Every image model takes this body.

A field the schema does not define answers 400 validation_error, naming it, so a typo never runs as an ignored setting. The task's request shows the body as it was accepted, with defaults filled in.

Sizes

You ask for a shape, not pixels, and Mynth picks the closest size the model serves. Omit size, or send "auto", and Mynth picks a ratio that suits the prompt.

A ratio the model has no preset for snaps to the closest one it serves. A 4k size costs per_image["4k"] and needs a model that has it. On a model without 4k the create answers 400 validation_error with the size to use instead, and nothing is queued. With model: "auto" the model is picked later, so the task fails with capability_not_supported instead.

What comes back

A completed task has one entry in result.images per requested image:

{
  "model": "black-forest-labs/flux.2-pro",
  "images": [
    {
      "status": "success",
      "id": "img_V1StGXR8Z5jdHi6BmyT0sC1pQ2rN4wLk",
      "url": "https://cdn.mynth.io/images/img_V1StGXR8Z5jdHi6BmyT0sC1pQ2rN4wLk.webp",
      "mynth_url": "https://cdn.mynth.io/images/img_V1StGXR8Z5jdHi6BmyT0sC1pQ2rN4wLk.webp",
      "size": "1536x1024",
      "format": "webp"
    }
  ]
}

• Check status on every image. One image failing does not fail the task. See tasks.
• url is where the file ended up: your storage when you named a destination, otherwise the same as mynth_url.
• size is the delivered file in {width}x{height} pixels.
• result.model is the model that ran.
• The file is served for 7 days. See file lifetimes.

Every field of the result is on the task object.

Price

The create response holds estimated_cost, and you pay only for the images that succeed. Pricing has the formula, and estimate cost prices a body without generating.

Next steps

• Choosing an image model: what to check before you pin an id.
• Image to image: send input images.
• Poll for results: collect the task over REST.