z-image-spicy/text-to-image
z-image-spicy/text-to-image
从文本提示生成高质量图片,支持 256 至 1536 像素自定义尺寸、智能提示词扩写和随机种子,适合创意设计与批量出图。
示例
参数
| 名称 | 类型 | 默认 | 约束 | 说明 |
|---|---|---|---|---|
| prompt *提示词 | textarea | — | ≤ 5000 chars | 描述期望的主体、动作、构图、镜头运动、光线与风格。 |
| width宽度 | slider | 1024 | 256 ~ 1536 · step 8 | 设置输出图片宽度,单位为像素。 |
| height高度 | slider | 1536 | 256 ~ 1536 · step 8 | 设置输出图片高度,单位为像素。 |
| prompt_extend提示词扩写 | boolean | true | — | 在生成前自动为较短的提示词补充视觉细节。 |
| seed随机种子 | number | — | ≥ 0 · step 1 | 用于复现结果的可选随机种子;留空时使用随机值。 |
输出字段
| 字段 | 类型 | 说明 |
|---|---|---|
| images | array<string> |
API
通过统一 REST API 调用本模型;在 API Keys 页获取密钥。
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);文档
z-image-spicy/text-to-image
通过简短或详细提示词生成自定义尺寸图片,并可选择自动扩写提示词。
z-image-spicy/text-to-image 是一款简洁直接的文本生成图片模型,适合插画、人像、概念设计、商品视觉和社交媒体素材。模型接收自然语言提示词,并允许在 256 到 1536 像素之间分别控制宽度和高度,步长为 8 像素。提示词扩写可以在生成前丰富较短的创意描述,可选随机种子则便于进行更稳定的对比探索。
核心特性
- 直接文本生成图片:将书面视觉描述转换为完整图片。
- 自定义宽高:宽度与高度可以独立设置,不受少量固定宽高比限制。
- 256 到 1536 像素范围:覆盖常见方图、竖图与横图布局。
- 8 像素精细步长:方便匹配后续排版、裁切和交付尺寸。
- 可选提示词扩写:在推理前为简短提示词补充有用的视觉细节。
- 随机种子控制:复用种子,可更稳定地比较提示词或尺寸变化。
技术规格
| 项目 | 说明 |
|---|---|
| 任务类型 | 文本生成图片 |
| 必填输入 | prompt |
| 默认尺寸 | 1024 x 1536 像素 |
| 宽度范围 | 256-1536 像素,步长 8 |
| 高度范围 | 256-1536 像素,步长 8 |
| 提示词扩写 | 支持,默认开启 |
| 可选输入 | seed |
| 输出 | 生成图片 URL |
示例提示词
黄昏时分,宇航员站在生物发光森林中,宇航服细节丰富,柔和蓝色轮廓光,电影感写实人像。极简香水瓶置于黑色反光玻璃上,高光受控,带有轻微薄雾,高级杂志商品摄影。等距视角的海滨生态城市,梯田式花园、电动交通、温暖晨光,清晰建筑插画。
计费
| 提示词扩写 | 每张价格 |
|---|---|
| 关闭 | 1.3 积分 |
| 开启 | 1.4 积分 |
以上数值原样反映现有 Marketplace 计费配置,本次文档修复不会修改价格。
最佳应用场景
- 人像、角色与编辑类插画概念。
- 商品样机与广告构图设计。
- 需要自定义横版或竖版尺寸的社交媒体素材。
- 环境、建筑与分镜方案探索。
使用建议
按照主体、构图、光线、媒介和氛围的顺序清晰描述画面,并在生成前选择与最终投放位置一致的尺寸。创意只有简短想法时可开启提示词扩写;当每个词都经过精确设计且需要按字面执行时,可以关闭扩写。比较小幅提示词或尺寸变化时,建议保持相同随机种子。
相关模型
xAI Grok Imagine Image v2.0 文生图
xAI Grok Imagine Image V2.0 文生图可根据文本提示词生成高质量图片,并支持配置宽高比、分辨率和质量,适用于创意视觉、社交内容、营销素材和生产工作流。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。
Qwen Image 3.0 Pro 文生图
Qwen Image 3.0 Pro 是一款专业级文生图模型,具备卓越画质和先进的提示词理解能力。最高支持 2k。提供开箱即用的 REST inference API,性能出色,无冷启动,价格实惠。
ai/prefect-pony-xl 动漫风格图片生成模型
Prefect Pony XL 可高质量生成动漫风格图片,适用于角色立绘和插画创作。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。
OpenAI GPT Image 2 文本生成图片
OpenAI 的 GPT Image 2 文本生成图片模型可根据自然语言提示词生成高质量图片。提供即用型 REST 推理 API,性能最佳,无冷启动,价格实惠。
OpenAI GPT Image 2 Edit 图像编辑
OpenAI 的 GPT Image 2 Edit 可通过自然语言指令结合一张或多张参考图片进行图像编辑。提供即用型 REST 推理 API,性能最佳,无冷启动,价格实惠。
OpenAI GPT Image 2.5 Sunburst 文本生成图片
面向复杂构图和高要求生产场景的高保真图片生成,最高支持 4K 输出。
OpenAI GPT Image 2.5 Flare 文本生成图片
根据自然语言提示词快速生成高质量图片,兼顾速度与效果,最高支持 4K 输出。
krea-v2-medium/text-to-image 文生图
Krea 2 Medium 文生图是一款快速的 AI 图片生成模型,可根据文本提示词生成高质量图片,并支持宽高比、创意程度和可选的风格参考控制。提供开箱即用的 REST 推理 API,适用于创意设计、营销视觉图、产品效果图、品牌素材、社交媒体内容、快速创意探索和专业文生图工作流,集成简单、无需冷启动、价格实惠。