下载 Markdown

更新日期

生图

默认同步接口:网关会等到生成完成或超时(最多 5 分钟)。超时 504 + gateway_timeout,不扣费。图生图也可走兼容路径 POST /v1/images/edits(见下方)。

同步成功/失败都会写入平台任务记录,门户与管理端任务列表可见(img_…)。同步成功响应体仍是 OpenAI 风格的 { created, data, usage },不含对外 id。

传 async: true 时,接口立即返回对外 task id(HTTP 200),用 GET /v1/tasks/{id} 轮询完成结果;不传或传 false 时走同步路径,直接返回最终图片。GET /v1/images/{id} 是同一查询的别名。

请求

字段类型必填说明
modelstring是对外 id(GET /v1/models?capability=image)
promptstring是文本提示
nint ≥ 1否请求张数;计费按实际返回张数;部分模型仅支持 1
sizestring否像素如 1024x1024,或档位如 2K(Seedream);以该模型实际支持为准
aspect_ratiostring否如 16:9 / 1:1;Gemini / 部分模型优先用;也可用 aspectRatio
qualitystring否如 low / high / hd;GPT-Image 等模型生效
backgroundauto | opaque | transparent否GPT-Image 背景透明度
moderationauto | low否GPT-Image 内容审核强度
output_formatpng | jpeg否Seedream 输出编码
watermarkboolean否Seedream「AI 生成」水印
optimize_prompt_optionsobject否Seedream 提示词优化,{ "mode": "standard" | "fast" }
sequential_image_generationauto | disabled否Seedream 组图
sequential_image_generation_optionsobject否{ "max_images": number },组图上限
asyncboolean否true 时立即返回 task id,走轮询;缺省或 false 走同步
response_formaturl | b64_json否默认 url。也可用 responseFormat
image / imagesstring | file | string[]否图生图参考。输入形态与别名见下方

常见模型族参数习惯

系列size 习惯参考图
Seedream2K / 2048x2048 等档位或像素image / images
ChatGPT / GPT-Image / DALL·E1024x1024、1536x1024、autoimage(部分模型支持多图)
Gemini / Imagen / Banana可用 aspect_ratio,或用像素 size 推导比例image / images
Grok 生图随模型而定;常见像素尺寸视该模型是否支持

换模型时只改 model(及该模型文档/列表里给出的可选参数),路径与鉴权不变。

curl https://tokenmei.com/v1/images/generations \
-H "Authorization: Bearer $MOMO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "一只橙猫走在雨夜霓虹街头",
  "n": 1,
  "size": "1024x1024",
  "response_format": "url"
}'

参考图输入形态

image / images 及下方别名,在 generations 与 edits 上支持三种入参(多值时取第一张)。文件与 base64 会先转存为平台公网 URL,再交给模型服务。

形态怎么传说明
公网 URLJSON 字符串,如 "https://cdn.example.com/ref.png"http:// / https:// 可直接用;该地址需可公网访问
Base64data:image/png;base64,...,或足够长且可识别为图片的裸 base64网关解码后转存;不要传本机文件路径冒充字符串
文件流multipart/form-data 字段(如 -F [email protected])与 OpenAI images.edit 常见写法一致;单文件上限约 10MB

不支持客户端本机路径(如 /Users/.../a.png、./ref.png、C:\...)。服务端不会读你的磁盘;请改成上传文件、公网 URL 或 base64。

字段名别名(写全,含 camelCase / snake_case):image、image_url、imageUrl、images、image_urls、imageUrls、input_image、inputImage、input_reference、inputReference、reference_image、referenceImage、reference_images、referenceImages、first_frame、firstFrame、first_frame_image、firstFrameImage、init_image、initImage、file。response_format 也可用 responseFormat。

公网 URL 示例:

json
{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "改成水墨风",
  "image": "https://cdn.example.com/ref.png"
}

Base64(data URL)示例:

json
{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "改成水墨风",
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}

Multipart 文件示例(generations 与 edits 均可):

bash
curl $BASE/v1/images/generations \
  -H "Authorization: Bearer $MOMO_API_KEY" \
  -F model=YOUR_IMAGE_MODEL \
  -F prompt="改成水墨风" \
  -F [email protected] \
  -F response_format=url

SDK 若不允许额外字段,用 HTTP 调同一路径,或改用下方的 edits。

OpenAI 兼容图编辑入口。与 images/generations + image 同一下游链路;差别是 image 必填。接受 JSON 或 multipart/form-data(官方 SDK images.edit 常见写法)。输入形态同上表(URL / base64 / 文件流)。

字段类型必填说明
modelstring是对外 id(平台必填;OpenAI 官方有时可省略)
promptstring是编辑说明
imagestring | file是源图;形态与别名见「参考图输入形态」
maskstring | file否兼容 OpenAI;同样支持 URL / base64 / 文件;可传但不参与生成
nint ≥ 1否同 generations
sizestring否同 generations
response_formaturl | b64_json否同 generations;也可用 responseFormat
asyncboolean否同 generations
bash
curl $BASE/v1/images/edits \
  -H "Authorization: Bearer $MOMO_API_KEY" \
  -F model=YOUR_IMAGE_MODEL \
  -F prompt="改成水墨风" \
  -F [email protected]

响应形状与 POST /v1/images/generations 相同。

响应

json
{
  "created": 1710000000,
  "data": [
    { "url": "https://cdn.example.com/a/xxx.png", "revised_prompt": null }
  ],
  "usage": {
    "images_generated": 1,
    "cost": { "amount": "0.2200", "currency": "CNY" }
  }
}
字段类型说明
createdintUnix 秒
dataarray每项一张图;计费按 data.length,不按请求里的 n
data[].urlstringresponse_format=url 时为平台转存后的稳定地址,不是临时链接
data[].b64_jsonstringresponse_format=b64_json 时直接给 base64,可跳过转存
data[].revised_promptnull固定为 null
usage.images_generatedint实际张数
usage.costobject可选,同对话的对外售价

b64_json 单项形如:

json
{ "b64_json": "...", "revised_prompt": null }

任务轮询(async: true)

async: true 时,POST /v1/images/generations 立即返回 task:

json
{
  "id": "img_a1b2c3d4e5f6",
  "object": "image",
  "model": "YOUR_IMAGE_MODEL",
  "status": "queued",
  "progress": 0,
  "created_at": 1710000000,
  "completed_at": null,
  "error": null
}
字段类型说明
idstring前缀 img_,用于轮询
objectstring固定 image
modelstring对外模型 id
statusstringqueued / in_progress / completed / failed
progressint0–100
created_atintUnix 秒
completed_atint | null未完成时为 null
errorstring | null成功为 null,失败为说明字符串
dataarray仅 completed 时出现,形状与同步生图一致

用这个 id 轮询(推荐统一路径):

GET /v1/images/{id} 返回同一份 JSON。

状态说明
queued / in_progress还没完成,不返回 data
completed成功后返回 data:[{ "url": "...", "revised_prompt": null }, …](可多张)
failed失败原因在 error

同步完成的任务若你知道 img_… public id(例如从门户任务列表复制),也可用 GET /v1/tasks/{id} / GET /v1/images/{id} 查询;data 含全部转存后的图片。异步 worker 路径当前仍按单结果 URL 落一张。完整约定见任务查询。

生图 · MomoAI算力超市