Generated Image Artifacts

Generated image output is defined as a durable skill-run artifact. Runtime generation is not currently exposed in Prompt Orchestra; this page describes the artifact shape that clients should expect once generated image output is supported.

Current status

Generated-image runtime is not currently available through the public API or SDK.

Do not treat generated images as runnable until the public API and SDK documentation include a supported invocation path.

Invocation path

V1 generated image output belongs to a skill run. The generated image must be inspectable through run detail alongside model, provider, prompt composition, version context, cost, usage, and typed failure state.

Durable artifact reference

Generated images use an object-storage reference:

kind
bucket
objectKey
optional signed URL metadata

The durable reference is bucket plus objectKey. A signed URL is only an access helper and may expire.

Model capability truth

Image-generation support is explicit metadata. Do not infer support from whether a model name contains image.

Model list items expose:

supportsImageGeneration
supportsImageInput
imageGenerationMode
inputModalities
outputModalities
capabilities

imageGenerationMode is one of:

none
direct_image_model
hosted_image_generation_tool

Direct image models generate images themselves. Hosted image-generation-tool-capable models are mainline models that can request image generation through a provider tool and may return provider outputs such as image_generation_call.

Image input support is separate from image output support. Image input, uploads, reference-image editing, realtime image generation, and video are not part of the current generated-image artifact surface.

Use model discovery with modalities=text,image when a client needs both direct image models and hosted-image-generation-tool-capable mainline models in the same catalog. Existing skill execution selectors can keep the default text-model discovery path.

Artifact shape

Generated image artifacts use artifactType: "generated_image" and attach to parentRunType: "skill_run".

The artifact includes:

artifactId
parentRunId
status
storage
request
modelExecution
context
usage
failure
createdAt
completedAt

modelExecution preserves the requested model and, when available, the underlying image model or hosted tool output type.

Failures

Generated image failures are typed:

provider_unavailable
unsupported_model
invalid_image_request
unsafe_image_request
generation_failed
artifact_storage_failed

Each failure includes a message and recovery guidance.