Create image generation

veryfront__create_image_generation

Requires project.files.write.

Access

No external-service connection is required. Use a Veryfront credential with access to the requested resources.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
project_referencestringNoProject ID or slug
promptstringYesText description of the desired image (max 1000 characters) Minimum length: 1. Maximum length: 1000.
countintegerNoNumber of images to generate (1-10, default: 1) Default: 1. Minimum: 1. Maximum: 10.
seedintegerNoRandom seed for reproducible generation Minimum: 1. Maximum: 999999.

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "veryfront__create_image_generation",
    "arguments": {
      "prompt": "example"
    }
  }
}

Result

The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.

FieldTypeRequiredDescription and constraints
requested_countintegerYesNumber of requested image slots, including failed and skipped items. Minimum: 1. Maximum: 10.
generated_countintegerYesImages successfully generated and stored. Minimum: 1. Maximum: 10.
failed_countintegerYesItems that failed, including admission refusals before provider work; not a count of billable calls. Minimum: 0.
skipped_countintegerYesItems not attempted because an earlier refusal or configuration failure stopped the batch. Minimum: 0.
resultsobject or object or object[]YesList of results associated with this tool result.

Full schemas

json
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "description": "Text description of the desired image (max 1000 characters)"
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Number of images to generate (1-10, default: 1)",
      "default": 1
    },
    "seed": {
      "type": "integer",
      "minimum": 1,
      "maximum": 999999,
      "description": "Random seed for reproducible generation"
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "description": "Images are generated by the EU Azure FLUX.2-pro deployment and saved as public CDN assets. They are not project uploads: upload visibility, grants and deletion do not apply to them.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}
json
{
  "type": "object",
  "properties": {
    "requested_count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Number of requested image slots, including failed and skipped items."
    },
    "generated_count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Images successfully generated and stored."
    },
    "failed_count": {
      "type": "integer",
      "minimum": 0,
      "description": "Items that failed, including admission refusals before provider work; not a count of billable calls."
    },
    "skipped_count": {
      "type": "integer",
      "minimum": 0,
      "description": "Items not attempted because an earlier refusal or configuration failure stopped the batch."
    },
    "results": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "index": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9,
                "description": "Zero-based position in the requested batch."
              },
              "outcome": {
                "type": "string",
                "const": "generated"
              },
              "url": {
                "type": "string",
                "minLength": 1
              },
              "upload_id": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Owned upload ID when this surface creates one; null for legacy CDN assets."
              },
              "error": {
                "type": "null",
                "description": "Error details returned by the tool."
              }
            },
            "required": [
              "index",
              "outcome",
              "url",
              "upload_id",
              "error"
            ],
            "additionalProperties": false,
            "description": "Structured option 1 details associated with this tool result."
          },
          {
            "type": "object",
            "properties": {
              "index": {
                "$ref": "#/properties/results/items/anyOf/0/properties/index",
                "description": "The index returned by the tool."
              },
              "outcome": {
                "type": "string",
                "const": "failed"
              },
              "url": {
                "type": "null"
              },
              "upload_id": {
                "type": "null"
              },
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "enum": [
                      "generation-failed",
                      "storage-failed",
                      "insufficient-credits",
                      "provider-spend-limit",
                      "provider-spend-unavailable",
                      "batch-stopped",
                      "not-configured"
                    ]
                  }
                },
                "required": [
                  "code"
                ],
                "additionalProperties": false,
                "description": "Safe failure classification; never contains raw provider or storage errors."
              }
            },
            "required": [
              "index",
              "outcome",
              "url",
              "upload_id",
              "error"
            ],
            "additionalProperties": false,
            "description": "Structured option 2 details associated with this tool result."
          },
          {
            "type": "object",
            "properties": {
              "index": {
                "$ref": "#/properties/results/items/anyOf/0/properties/index",
                "description": "The index returned by the tool."
              },
              "outcome": {
                "type": "string",
                "const": "skipped"
              },
              "url": {
                "type": "null"
              },
              "upload_id": {
                "type": "null"
              },
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "const": "batch-stopped"
                  }
                },
                "required": [
                  "code"
                ],
                "additionalProperties": false,
                "description": "Error details returned by the tool."
              }
            },
            "required": [
              "index",
              "outcome",
              "url",
              "upload_id",
              "error"
            ],
            "additionalProperties": false,
            "description": "Structured option 3 details associated with this tool result."
          }
        ],
        "description": "One outcome per requested image, in request order. Skipped items were not attempted."
      },
      "minItems": 1,
      "maxItems": 10,
      "description": "List of results associated with this tool result."
    }
  },
  "required": [
    "requested_count",
    "generated_count",
    "failed_count",
    "skipped_count",
    "results"
  ],
  "additionalProperties": false,
  "description": "A batch with at least one stored image. requested_count equals generated_count + failed_count + skipped_count. A batch with no stored images remains an error.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}