如何使用 MOSS Image 文生图 API：文生图接入指南（2026）

2 min · 更新于 2026-07-11 · NamiFusion 团队

MOSS Image 文生图 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。

MOSS Image 文生图是一款文生图模型（由 Moss Image 提供）：支持中英文文字渲染、15 种宽高比和 1K～2K 输出的文生图模型。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.020。

TL;DR

· 任务类型：文生图，由 Moss Image 提供

· 价格：典型一次调用约 $0.020（$1 = 100 积分），按量计费无订阅

· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入

· 可调参数：5 个（见下方参数表）

· 无平台水印，商用可用（遵守服务条款）

用 MOSS Image 文生图能做什么？

社媒配图与封面：按帖子主题批量出图，统一风格后直接排期发布。

电商与广告素材：产品场景图、Banner 底图、A/B 测试的多版本视觉。

概念设计与灵感探索：角色、场景、风格板，用低成本快速迭代方向。

内容工作流串联：生成结果可直接作为图生视频或换脸的输入素材。

怎么调用这个 API？

在 NamiFusion 注册并在 API Keys 页面创建密钥（注册赠送积分仅可用于指定模型）。
用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
用返回的 task_uuid 轮询任务状态，完成后取输出 URL。

提交任务

# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/moss-image/text-to-image" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A modern tea house poster with a sign reading \"MOSS TEA HOUSE\", warm lighting and clean typography.",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "output_format": "jpeg",
    "seed": -1
  }
}'

# 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"

有哪些参数？

prompt（提示词）：必填

aspect_ratio（宽高比）：可选，默认 "1:1"

resolution（分辨率）：可选，默认 "1k"

output_format（输出格式）：可选，默认 "jpeg"

seed（随机种子）：可选

MOSS Image 文生图的提示词怎么写？

主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。
用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。
负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。

价格是多少？

按次积分计价，典型一次调用约 $0.020（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。

MOSS Image 文生图

moss-image/text-to-image

支持中英文文字渲染、15 种宽高比和 1K～2K 输出的文生图模型。

输入参数

参数	类型	必填	默认值	限制与说明
`prompt`	string	是	—	最多 5000 字符（平台限制）; 用于生成的正向提示词。支持较长且详细的提示词，并可在图片中渲染中英文文字。
`aspect_ratio`	string	否	"1:1"	1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9; 生成图片的宽高比。
`resolution`	string	否	"1k"	1k, 1.5k, 2k; 输出总分辨率档位：1k（约 100 万像素）、1.5k（约 240 万像素）或 2k（约 400 万像素）。
`output_format`	string	否	"jpeg"	jpeg, png, webp; 输出图片的格式。
`seed`	integer	否	—	用于生成的随机种子。-1 表示将使用随机种子。

仅 prompt 必填。seed 必须为整数，-1 表示随机种子。resolution 是总像素档位，并非固定宽度或高度。本 Nami 接口返回异步任务及图片 URL，不开放上游的 enable_sync_mode 和 enable_base64_output 开关。

每张图片价格

Resolution	USD	Credits
1k	$0.020	2
1.5k	$0.040	4
2k	$0.080	8

每次请求生成一张图片。标价与 WaveSpeed 一致，1 美元 = 100 积分。只有 resolution 影响价格，宽高比、输出格式和种子不额外收费；账户折扣另行计算。

API

curl -X POST https://www.namifusion.com/api/v1/marketplace/run/moss-image/text-to-image \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "prompt": "A modern tea house poster with a sign reading \"MOSS TEA HOUSE\", warm lighting and clean typography.",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "output_format": "jpeg",
    "seed": -1
  }
}'

curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
  -H "Authorization: Bearer $API_KEY"

提交一次，从响应读取 task_uuid，再轮询至 completed 或 failed。完成后 output.images 为图片 URL 数组。

WaveSpeed API reference

完整参数表、输出字段与实时价格 →

常见问题

可以先免费试用吗？+

注册赠送积分仅可用于指定模型，适用范围会持续更新；Playground 提交前会显示准确报价。

生成内容可以商用吗？有水印吗？+

可以商用，NamiFusion 不给生成结果加平台水印；使用须遵守服务条款与适用法律。

内容政策是什么？+

色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许，详见服务条款。

MOSS Image 文生图的任务要跑多久？+

取决于参数，图像通常数秒到数十秒，视频通常数十秒到几分钟；API 返回 task_uuid 供轮询。

分辨率/时长上限是多少？+

以模型参数表为准：每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。

免费试用 →