图像

第 3 版 · 更新于 2026-11-12 · 阅读约 6 分钟

通过 Runtoken 生成或编辑图像。

选择操作#

图像生成和图像编辑使用不同的接口及请求体格式。先从模型目录或 GET /v1/models 选择模型，再确认它支持需要的操作。请求中填写平台模型 ID，不使用模型家族名称代替。

• 图像生成：POST /v1/images/generations，使用 JSON 请求体。
• 图像编辑：POST /v1/images/edits，使用 multipart 请求体。

两种请求均发送至 https://api.runtoken.net，并携带 Authorization: Bearer YOUR_PLATFORM_KEY。将 YOUR_PLATFORM_KEY 替换为在控制台创建的平台 API Key。

这些接口不代表所有模型都具备相同能力。参考图生成与 multipart 图像编辑是两种操作，支持前者不代表支持后者。

当前支持的图像家族#

当前图像接入覆盖以下家族和请求类型。此处说明平台的支持范围，不代表各厂商的所有模型版本均已开放。实际请求应使用平台模型目录中的可调用模型 ID。

这些名称不能直接作为请求中的 model 值。尺寸、质量、多图输出、参考图和编辑等字段，取决于具体模型版本与平台接入。

OpenAI 兼容图像生成#

选择接受 OpenAI 兼容图像请求格式的模型，通过 JSON 生成接口调用。计费需要模型对应平台价格规则要求的图像数量或 token 用量依据。

协议兼容不代表支持所有 OpenAI 图像参数或编辑操作。下方生成示例仅适用于接受其中字段的模型。

GPT Image#

GPT Image 支持 /v1/images/generations 和 /v1/images/edits，请求字段遵循所选 GPT Image 版本的要求。

请求同步返回，不支持流式生成、后台任务或部分图像输出。按 token 计费时，响应需要提供可核验的文本与图像 token 明细，不能根据出图数量推算 token。

Seedream#

Seedream 支持同步 JSON 生成，以及当前接入能够识别的单图参考或编辑输入。这不等于通用 multipart 编辑能力，不能在未确认模型输入格式时直接套用下方编辑命令。

按像素档位计费时，需要可核验的输出图像数量和尺寸。标准像素档位规则要求返回一张图像；图层分解需要平台明确配置对应价格，不是默认开放的能力。

Ark 原生图像生成#

此类接入采用 Ark 原生请求与响应映射，提供图像生成能力。标准固定单价规则按生成图像数量计费，不提供通用图像编辑能力。

只有平台明确配置了价格、且请求通过相应校验时，才适用图层计费。不能从支持图像生成推断支持图层生成。

百炼 Qwen 3.0 图像#

当前接入支持图像生成，不提供通用编辑能力。原生用量依据需要包含输入和输出图像数量、尺寸及图像档位。

当前计费处理范围最多为 3 张输入图像和 6 张输出图像。这是计费处理的边界，不代表每个 Qwen 模型都支持相应张数。所选模型的 API 限额及输入图像优惠，仍需按该模型在平台上的实际配置分别确认。

生成图像#

以下示例使用常见的 OpenAI 兼容图像字段，通过文本提示词请求生成一张图像。请用于接受这些字段的模型；采用其他原生 JSON 结构的模型，需要使用对应的请求体。

curl 'https://api.runtoken.net/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_PLATFORM_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "prompt": "A blue bird",
    "n": 1
  }'

运行示例前，请替换以下占位值。

生成图像的内容和数量由以下参数指定。

编辑图像#

选择支持 multipart 编辑的模型，通过文件字段上传原图，在 prompt 中描述需要的修改。支持参考图输入的生成模型，不一定支持这个接口。

curl 'https://api.runtoken.net/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_PLATFORM_KEY' \
  -F 'model=YOUR_MODEL_ID' \
  -F 'image=@YOUR_INPUT_IMAGE.png' \
  -F 'prompt=Add a blue sky'

运行示例前，请替换以下占位值。

curl 的 @ 语法用于读取文件；-F 会构造 multipart 请求体及其 Content-Type。

输入与结果#

开放上传或展示结果前，先核对所选模型的输入输出要求。不同模型家族的原生字段不能直接互换。

编辑示例中的 .png 用于指明本地文件，不代表接口接受的完整格式列表。同样，n: 1 只是示例出图数量，不是全平台默认值或上限。

Runtoken 不会将响应转换成另一家厂商的格式。不要假设所有结果都包含可下载 URL，也不要用同一套字段解析所有模型的响应。

当前限制#

当前图像接入同步返回结果，不支持以下能力：

• 流式图像生成。
• 后台或异步图像任务。
• 部分图像输出。
• 通过工具调用生成图像。

支持生成不代表支持编辑。多图输出、参考图和图层分解也需要模型与平台明确支持，不能通过复制其他厂商示例中的字段直接开启。

计费#

图像计费以同步返回的图像结果，以及相应计费规则要求的可核验用量为依据。不同模型所需的依据可能包括图像数量、尺寸，或文本与图像 token 明细。

不能用出图数量推算 token 用量。用量证据缺失或不一致时，请求可能进入计费复核。

销售价格及适用条件以平台模型目录为准，包括像素档位、质量选项和输入图像优惠。厂商官方价格不等于 Runtoken 的销售价格。token 单价为零也不代表图像请求免费，模型可能采用其他计价方式。

下一步#

语音合成与转写见音频，通用的路由和计费规则见接入指南。