图像生成 API

通过 宁享Token 的图像生成 API，你可以根据文本描述生成图像、对现有图像进行变体创作或风格迁移。我们支持业界主流的图像生成模型。

支持的供应商

供应商	模型	协议格式	说明
火山方舟	doubao-seedream-4-0 / 5-0 / 5-0-pro（含在售日期版）	OpenAI 兼容	文生图 / 图生图，中文理解优秀
阿里云	wan2.7-image / wan2.7-image-pro	OpenAI 兼容	万相 2.7 图像（按张计费）
谷歌 (Google)	gemini-3-pro-image（及 -preview）	OpenAI 兼容	Gemini 图像生成
OpenAI	gpt-image-2 / gpt-image-2-vip	OpenAI 兼容	GPT 图像生成
Nano Banana	nano-banana-2 / nano-banana-pro	OpenAI 兼容	轻量快速图像生成
快手可灵	kling-v3	OpenAI 兼容	可灵 Image 3.0（官方 POST /v1/images/generations，1K/2K）
其他	omni-image、image-recognize	OpenAI 兼容	通用图像 / 图像识别

统一调用方式

OpenAI 兼容端点：

POST /v1/images/generations

快速开始

from openai import OpenAI

client = OpenAI(
    base_url="/v1",
    api_key="<YOUR_API_KEY>",
)

resp = client.images.generate(
    model="doubao-seedream-5-0",
    prompt="一只穿宇航服的柴犬，赛博朋克风格",
    size="1024x1024",
    n=1,
)
print(resp.data[0].url)

如何选择模型

• 通用文生图 / 图生图：doubao-seedream-5-0 / 5-0-pro（中文理解优秀）
• 低成本快速生成：doubao-seedream-5-0
• 万相图像：wan2.7-image / wan2.7-image-pro（阿里万相 2.7）
• 图像识别 / 理解：image-recognize
• 可灵图像：kling-v3（官方 Kling Image 3.0；模型名用官方的 model_name 字段传，model 亦可）

可灵（Kling）图像模型

官方文档：klingai.com › 图片生成（POST /v1/images/generations）

照官方文档原样发即可（下列请求体与官方 Request Example 同形）：

POST /v1/images/generations
{
  "model_name": "kling-v3",
  "prompt": "生成皮克斯风格的小狗",
  "n": 2,
  "size": "1280x720"
}

我方字段	类型	必填	对应官方字段	说明
model_name	string	二选一	model_name	官方现行字段，支持照官方文档原样传。取值 kling-v3（官方枚举里的 kling-v2-1 本平台暂未开通，请改用 kling-v3）
model	string	二选一	model_name	OpenAI 兼容写法（本平台扩展）：本平台自动把它转成官方 model_name 发上游。与 model_name 同时出现时以 model_name 为准
prompt	string	是	prompt	≤ 2500 字符
n	int	否	n	生成张数，官方范围 [1, 9]；越界返回 400（客户端参数错误，不重试）
size	string	否	aspect_ratio + resolution	如 1280x720，本平台折成最接近的官方比例与清晰度档
negative_prompt	string	否	negative_prompt	负向提示词（图生图场景不支持）
image	string	否	image	参考图 URL 或 base64（不要带 data:image/...;base64, 前缀）
resolution	string	否	resolution	1k / 2k；显式传值时优先于 size 推导
aspect_ratio	string	否	aspect_ratio	16:9/9:16/1:1/4:3/3:4/3:2/2:3/21:9
watermark	bool	否	watermark_info.enabled	是否同时生成含水印结果
callback_url / external_task_id	string	否	同名	回调地址 / 自定义任务 ID

⚠️ model_name 与 model 至少要传一个。 官方「两个都不传 ⇒ 用默认 kling-v3」这条默认值 在本平台不适用：本平台是多厂商交换机，一个不带模型名的请求体不携带厂商信息，无法判断 你要的是可灵还是其它供应商，因此会落到平台默认模型并返回「无可用渠道」。请按上表二选一。

⚠️ 本平台同时在内部轮询上游任务；若你另传 callback_url，结果会被投递两次 （一次回调、一次本同步响应），请按 task_id 去重。

计费：按张计价（单价 × n），与其他图像模型一致。

⚠️ 上游为异步任务（创建返回 task_id，再查询取图）。本平台的 /v1/images/generations 保持 同步语义：内部轮询到任务完成后再返回 data[].url。若等待超过上限（默认 5 分钟，可由部署侧 KLING_IMAGE_POLL_TIMEOUT_MS 调整），返回明确错误（含上游 task_id），不会返回「成功但没有图」。

• 通用图像模型：omni-image

文档目录

• 豆包 Seedream OpenAI 格式

计费

图像生成按「张数」计费，不同模型单价不同，具体以 宁享Token 控制台公示为准。所有费用以 CNY 结算。

常见问题

生成的图片是否可商用？

各模型授权范围不同，请参考对应模型说明页的授权说明。默认情况下，宁享Token 平台生成的图片可商用。

是否支持流式生成？

图像生成不支持流式输出，每个请求会阻塞直到图片生成完成或失败。典型耗时 5~60 秒。

如何获取图片？

响应中的 data[].url 字段为图片下载地址，URL 有效期 1 小时，请及时下载。