Text to ImageZ Image Spicy

z-image-spicy/text-to-image

z-image-spicy/text-to-image

Generate high-quality images from text with custom dimensions from 256 to 1536 pixels, intelligent prompt rewriting, and seed control for creative design and batch generation.

Examples

z-image-spicy/text-to-image Examples 1

Parameters

NameTypeDefaultConstraintsDescription
prompt *Prompttextarea—≤ 5000 charsDescribes the desired subject, action, composition, camera movement, lighting, and style.
widthWidthslider1024256 ~ 1536 · step 8Sets the output image width in pixels.
heightHeightslider1536256 ~ 1536 · step 8Sets the output image height in pixels.
prompt_extendPrompt Extendbooleantrue—Automatically expands short prompts with additional visual detail before generation.
seedSeednumber—≥ 0 · step 1Optional random seed for reproducible results; leave empty to use a random seed.

Output fields

FieldTypeDescription
imagesarray<string>Generated image URL(s).

API

Call this model through one unified REST API. Get a key on the API Keys page.

cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/z-image-spicy/text-to-image" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A cinematic portrait of an astronaut in a bioluminescent forest at dusk, intricate suit details, soft blue light, photorealistic.",
    "width": 1024,
    "height": 1536,
    "prompt_extend": true
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"
Python
import time, requests

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1) Submit
resp = requests.post(
    "https://www.namifusion.com/api/v1/marketplace/run/z-image-spicy/text-to-image",
    headers=HEADERS,
    json={
        "input": {
            "prompt": "A cinematic portrait of an astronaut in a bioluminescent forest at dusk, intricate suit details, soft blue light, photorealistic.",
            "width": 1024,
            "height": 1536,
            "prompt_extend": True
        }
    },
)
resp.raise_for_status()  # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()

# 2) Poll until a terminal state (completed / failed / cancelled).
#    This model is allowed up to 180s server-side.
deadline = time.time() + 240
while task.get("status") not in ("completed", "failed", "cancelled"):
    if time.time() > deadline:
        raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
    time.sleep(3)
    poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
    poll.raise_for_status()
    task = poll.json()

print(task["status"], task.get("output"))
JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };

// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/z-image-spicy/text-to-image", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "input": {
      "prompt": "A cinematic portrait of an astronaut in a bioluminescent forest at dusk, intricate suit details, soft blue light, photorealistic.",
      "width": 1024,
      "height": 1536,
      "prompt_extend": true
    }
  }),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();

// 2) Poll until a terminal state (completed / failed / cancelled).
//    This model is allowed up to 180s server-side.
const deadline = Date.now() + 240 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
  if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
  await new Promise((r) => setTimeout(r, 3000));
  const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
  if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
  task = await poll.json();
}

console.log(task.status, task.output);

Documentation

z-image-spicy/text-to-image

Create custom-size images from concise or detailed prompts, with optional automatic prompt expansion.

z-image-spicy/text-to-image is a streamlined text-to-image model for illustrations, portraits, concept art, product visuals, and social creative. It accepts a natural-language prompt and exposes direct width and height controls from 256 to 1536 pixels in 8-pixel steps. Prompt expansion can enrich a short idea before generation, while an optional seed supports repeatable exploration.

Key Features

  • Direct text-to-image generation: Converts a written visual description into a finished image.
  • Custom dimensions: Set width and height independently instead of being limited to a short list of aspect ratios.
  • Broad 256-1536 pixel range: Covers square, portrait, and landscape layouts for common digital uses.
  • 8-pixel increments: Fine-grained dimensions help match downstream composition requirements.
  • Optional prompt expansion: Adds useful visual detail to brief prompts before inference.
  • Seed control: Reuse a seed to compare prompt or dimension changes more consistently.

Technical Specifications

ItemDetails
TaskText-to-image generation
Required inputprompt
Default dimensions1024 x 1536 pixels
Width range256-1536 pixels, step 8
Height range256-1536 pixels, step 8
Prompt expansionSupported and enabled by default
Optional inputseed
OutputGenerated image URL

Sample Prompts

  • A cinematic portrait of an astronaut in a bioluminescent forest at dusk, intricate suit details, soft blue rim light, photorealistic.
  • A minimalist perfume bottle on black reflective glass, controlled highlights, subtle mist, premium editorial product photography.
  • An isometric coastal eco-city with terraced gardens, electric transit, warm morning light, clean architectural illustration.

Pricing

Prompt expansionPrice per image
Disabled1.3 credits
Enabled1.4 credits

These values reproduce the existing Marketplace pricing configuration; this documentation update does not alter pricing.

Best Use Cases

  • Portrait, character, and editorial illustration concepts.
  • Product mockups and advertising compositions.
  • Social media graphics in custom portrait or landscape dimensions.
  • Environment, architecture, and storyboard exploration.

Best Practices

Describe the subject, composition, lighting, medium, and mood in a clear order. Choose dimensions that match the final placement before generating. Enable prompt expansion for short ideas; disable it when every phrase has been carefully authored and should remain literal. Use the same seed when comparing a small prompt or size change.

Related models

xAI Grok Imagine Image v2.0 Text to Image
Text to ImageX Ai

xAI Grok Imagine Image v2.0 Text to Image

xAI Grok Imagine Image V2.0 Text-to-Image generates high-quality images from text prompts, with configurable aspect ratio, resolution, and quality for creative visuals, social content, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.080 / per run
Qwen Image 3.0 Pro Text to Image
Text to ImageQwen Image 3.0 Pro

Qwen Image 3.0 Pro Text to Image

Qwen Image 3.0 Pro is a professional-grade text-to-image model with superior quality and advanced prompt understanding. Up to 2k. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.075 / per run
ai/prefect-pony-xl
Text to ImagePrefect Pony Xl

ai/prefect-pony-xl

Prefect Pony XL delivers high-quality anime-style image generation for character art and illustrations. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.015 / per run
OpenAI GPT Image 2 Text-to-Image
Text to ImageOpenAI

OpenAI GPT Image 2 Text-to-Image

OpenAI's GPT Image 2 Text-to-Image generates high-quality images from natural-language prompts. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.660 / per run
OpenAI GPT Image 2 Edit
Text to ImageOpenAI

OpenAI GPT Image 2 Edit

OpenAI's GPT Image 2 Edit enables image editing from natural-language instructions with one or more reference images. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.660 / per run
OpenAI GPT Image 2.5 Sunburst Text-to-Image
Text to ImageOpenAI

OpenAI GPT Image 2.5 Sunburst Text-to-Image

High-fidelity image generation for detailed compositions and demanding production work, with up to 4K output.

from $0.220 / per run
OpenAI GPT Image 2.5 Flare Text-to-Image
Text to ImageOpenAI

OpenAI GPT Image 2.5 Flare Text-to-Image

Fast, balanced image generation from natural-language prompts, with up to 4K output.

from $0.220 / per run
krea-v2-medium/text-to-image
Text to ImageKrea V2 Medium

krea-v2-medium/text-to-image

Krea 2 Medium Text to Image is a fast AI image generation model that creates high-quality images from text prompts with aspect ratio, creativity, and optional style reference controls. Ready-to-use REST inference API for creative design, marketing visuals, product mockups, brand assets, social media content, rapid ideation, and professional text-to-image workflows with simple integration, no coldstarts, and affordable pricing.

from $0.030 / per run