popiskill-image-text2image-basic-v1

name	popiskill-image-text2image-basic-v1
description	Generate one image from text through the PopiArt runtime baseline. Use this when the user wants the most direct text-to-image path for smoke tests, concept frames, or simple creator-agent image generation.
tags	["official","runtime","image","text2image","basic"]
version	v1
model_type	image
estimated_duration_s	120
default_profile	true
profile_description	Official PopiArt runtime baseline for single-image text-to-image generation.

PopiArt Text To Image Basic

This is an official PopiArt runtime catalog skill.

• Popiart_skillhub owns the public skill definition.
• popiartServer owns registration, execution, jobs, artifacts, and stable media URLs.
• PopiNewAPI owns provider routing and upstream model access.
• popiartcli owns discovery, auth UX, run, jobs, and artifacts.

Use it when the goal is to:

• turn one prompt into one image
• validate that the PopiArt image path is alive end to end
• generate one quick concept frame without a multi-step workflow

Do not use it for:

• source-image editing
• multi-shot storyboards
• video output

Required input

• prompt: the main image request

Optional input

• negative_prompt
• style
• size
• aspect_ratio
• seed
• notes

Workflow

1. Authenticate with a PopiArt product-layer key if needed.
2. Build the smallest valid JSON payload.
3. Run the skill through popiart.
4. Wait for completion.
5. Pull the returned artifact when a local file is needed.

Command pattern

popiart run popiskill-image-text2image-basic-v1 --input @params.json --wait

Inline example:

popiart run popiskill-image-text2image-basic-v1 --input '{"prompt":"a cinematic tea shop at sunset","aspect_ratio":"16:9","style":"soft anime lighting"}' --wait

Payload template

{
  "prompt": "a cinematic tea shop at sunset",
  "style": "soft anime lighting",
  "aspect_ratio": "16:9",
  "seed": 42
}

Output handling

After the job finishes:

• read job_id
• read artifact_ids
• inspect url or media_id when a stable media URL is returned
• use popiart artifacts pull <artifact-id> when a local file is needed

Operating guidance

• Prefer size when the runtime contract already exposes exact dimensions.
• Use aspect_ratio when you want a portable request that the server can map safely.
• If the user needs source-image conditioning, switch to popiskill-image-img2img-basic-v1.
• If the user needs motion, switch to popiskill-video-image2video-basic-v1.