生成图片或视频

POST /api/generate/v2

提交图片或视频生成请求。生成异步进行 — 使用状态查询端点轮询完成情况。同一端点同时支持图片模型（GPT Image 2.5、GPT Image 2、Nanobanana、Seedream、Midjourney 等）和视频模型（Seedance 2.5、Seedance 2.0、Veo 3.1、Grok Video 等），通过 modelId 选择。

请求

请求头

Header	值
Authorization	`Bearer meigen_sk_YOUR_API_KEY`
Content-Type	`application/json`

请求体参数

string

必填

GPT Image 2 与 2.5 的长提示词会自动压缩以适配模型限制，请明确写出关键要求和需要保留的内容。要生成的图片或视频的文本描述。要引用已创建的角色，在文本中内嵌 [character:<uuid>] ——例如 "[character:550e8400-e29b-41d4-a716-446655440000] standing in a neon-lit alley, cinematic lighting"。每次生成最多引用 3 个角色。支持范围：所有接受参考图的图片模型（Flux 2 Klein 除外）+ 视频侧 Seedance 2.5 / 2.0。角色图片与用户上传图片共用内容参考图预算。模型不支持、角色不存在或无权访问、引用数超限均返回 400（characters_not_supported、character_not_found、too_many_characters）；部分角色需要更高的 tier（character_tier_required）。

string

用于生成的模型。不传则使用平台当前默认模型（可能随平台配置变化）。模型列表是模型 ID 的权威来源。 模型会不断上新与下线，请在运行时动态解析 ID，不要在自己这边硬编码一份模型清单。该端点返回的所有模型都可用于本端点，API Token 调用同样不受限。常用取值：图片 gpt-image-2.5、gpt-image-2、nanobanana-2、midjourney-v8.1；视频 seedance-2-5、seedance-2-0、veo-3.1。

rhart-1.5（GPT image 1.5）已于 2026-04-22 下线，请改用 gpt-image-2。midjourney-v7 已于 2026-05-09 由 midjourney-v8.1 接替（出于向后兼容仍接受老 ID 调用）。

string

默认值:"auto"

生成媒体的宽高比。

默认 auto（推荐）：为你自动挑选合适的比例。
也可显式指定——必须是模型列表返回的 supported_ratios 之一。常见图片比例：1:1, 3:4, 4:3, 16:9, 9:16, 21:9, 5:4, 4:5。
Seedance 2.5 和 2.0 还接受 adaptive，让输出跟随输入素材；首帧/末帧和 referenceVideo 请求使用该值。
Seedance 2.5 的文生视频或 referenceMode: content 请求如需明确画幅，请传受支持的具体比例。
Seedance 2.0 上不传 aspectRatio（或传了无法识别的取值）都会解析为 adaptive。 纯文生视频没有可供自适应的参考，因此不带参考图/参考视频时请显式指定比例。

最终采用的比例会同时在本端点的响应和状态端点的 aspectRatio 字段返回。

string

输出分辨率。可用性取决于模型。不传则使用所选模型的默认分辨率。可选值取决于模型：图片模型用 1K / 2K / 3K / 4K；视频模型用 480p / 720p / 1080p / 4k（视频侧的 k 是小写）。Seedance 2.5 仅支持 480p / 720p；Seedance 2.0 的 pro 档增加 1080p / 4k，Veo 3.1 也支持 4k。Seedance 2.0 带 referenceVideo 时最高 1080p。完整矩阵见模型对比。

string

质量选项按模型区分。GPT Image 2.5 支持 low（Standard）、medium（Medium）、high（High）、xhigh（Extra High）、max（Max）。GPT Image 2 仅支持 low / medium / high。GPT Image 模型省略此字段或传 auto 时使用模型配置的默认值（当前为 low）。Grok Imagine Image 2.0 支持 low（Standard，默认）/ medium。通过模型列表读取 extra_config.qualities 与 extra_config.pricing。GPT 不支持的质量值返回 400 / unsupported_quality。

string

仅 GPT Image 2.5 支持：sunburst（质量优先，配置默认值）或 flare（速度优先）。两者都支持图片生成和参考图编辑，同分辨率、同质量下同价。添加参考图不会自动改变此设置。与 modelId: "gpt-image-2.5" 一起使用。不要把型号选项名称当作独立模型 ID，也不要为 GPT Image 2 或其他模型传此字段。非法组合返回 400 / unsupported_model_variant。

string[]

参考图数组。每一项必须是可公开访问的 HTTP(S) URL，或形如 data:image/png;base64,... 的内联 base64 数据。本地文件路径（如 C:/Users/...）与 file:// URI 会被拒绝，返回 400 / invalid_reference_url。

Agnes Video 2.5 Flash —— 图生视频会忽略 aspectRatio。 该模型的输出比例由首帧图本身决定。对托管在 images.meigen.ai 上的图片（你在 MeiGen 生成或上传过的），我们会先在 CDN 边缘把首帧裁到你请求的 aspectRatio，因此输出与你选的比例一致；对其他来源（外部 URL 或 data: base64），图片原样透传，输出比例跟随你的图片，而不是 aspectRatio。如果外部图片也需要精确的输出比例，请在发送前自行裁到该比例，或改传此前生成产物的 imageUrl（本来就在我们 CDN 上）。

最大数量按模型不同。图片模型和视频首帧/末帧输入请读模型列表返回的 max_reference_images；Seedance 的 content 模式改读 extra_config.maxContentReferenceImages。撰写时的实况：

上限	模型
16	GPT Image 2.5, GPT Image 2.0
14	Nanobanana 2、Nanobanana Pro
10	Seedream 5.0 Pro、Seedream 4.5
3	Grok Imagine Image 2.0
2	Seedance 2.5、Seedance 2.0、Veo 3.1 —— 默认 `frame` 模式（首/尾帧），见下方 `referenceMode`
1	Midjourney V8.1、Agnes Image 2.1 Flash、Agnes Video 2.5 Flash、Grok Video 1.5(必传 —— 仅支持图生视频)
0	Flux 2 Klein

content 模式下，Seedance 2.5 最多接受 30 张图片，Seedance 2.0 最多 9 张；使用角色时，角色解析出的图片也计入同一上限。

string[]

可选的 Seedance 结构化首尾帧输入，顺序为首帧、末帧，最多 2 张。需要同时控制首尾帧与内容参考时，可与 contentReferenceImages 一起使用。结构化字段优先于旧的 referenceImages / referenceMode 组合。

string[]

可选的 Seedance 结构化内容参考图：Seedance 2.5 最多 30 张，Seedance 2.0 最多 9 张。可与 frameReferenceImages、referenceVideo 和角色引用同时使用。图片与视频分别计数；角色图片计入本图片上限。

string

默认值:"frame"

仅用于 Seedance 2.5 和 Seedance 2.0，决定其 Provider 如何解读 referenceImages。

frame（默认）—— 首/尾帧参考，最多 2 张
content —— 内容参考，不绑定具体帧位置。当前 API 上限请读 extra_config.maxContentReferenceImages（Seedance 2.5 为 30，Seedance 2.0 为 9）

Veo、Grok、Agnes 视频模型不要传此字段：它们的 Provider 不实现内容参考模式，仍按各自的常规帧语义处理。超过受支持的上限会返回 400——Seedance frame 模式为 frame_reference_limit，内容参考或其他模型上限为 too_many_references。

object

Midjourney V8.1 高级参数。对其他模型无效。（字段名沿用历史命名，向后兼容。）

字段	类型	默认值	范围	说明
stylize	number	100	0-1000
chaos	number	5	0-100
raw	boolean	false	—
iw	number	1	0-2
sref	string	—	URL 或文本
sw	number	100	0-1000
profile	string	—	字母数字档案码	Midjourney 个性化档案；可与 `sref` 同时使用
quality	string	`4`	`1` 或 `4`	默认 High（4 倍算力，不额外计费）

string

默认值:"content"

仅用于 Midjourney V8.1。参考图片的解读方式。

content — 用作主题素材参考
style — 仅提取视觉风格

number

视频时长(秒)。不传则按该模型自身的默认时长出片与计费:

模型	可选值	默认
Seedance 2.5	4-30	4
Seedance 2.0	4-15	4
Veo 3.1	仅 4、6、8	4
Grok Video 1.5	4-15	4
Agnes Video 2.5 Flash	仅 5(固定)	5

实际扣除的积分始终以响应中的 creditsUsed 为准,不要自行推算。

string

支持多档位模型的画质档位。

Seedance 2.0:mini(默认)、fast 或 pro
Veo 3.1:fast(默认)或 pro

Seedance 2.5 没有档位，请省略该字段。更高档位画质更好、价格也更高；不传则使用模型默认档，Seedance 2.0 默认为 mini。完整价格矩阵见模型。

string

Seedance 2.5 或 Seedance 2.0 续写所用的参考视频 URL。必须是可公开访问的 HTTPS URL（通常来自之前生成结果的 videoUrl）。

模型	参考输入	输出	带参考视频单价
Seedance 2.5	2–30 秒、≤200MB	4–30 秒；480p / 720p	11 / 24 积分/秒
Seedance 2.0	2–15 秒、≤50MB	4–15 秒；按档位，最高 1080p	Mini 7/13、Fast 8/14、Pro 16/28 积分/秒

两个模型都按 计费秒数 = max(参考视频时长 + 输出时长, 最低计费秒数)。完整费率和示例见模型。系统会自动识别参考视频真实时长。参考视频可与内容参考图一起提交，两者上限互不占用。

number

已弃用的兼容提示，新集成应省略。若仍传入，必须是有限的非负数，服务端可能用它与探测值做诊断比对，但它不决定计费或裁剪。Seedance 2.5 / 2.0 续写均以服务端探测到的真实时长为准。

string

可选 UUID。用于防止重复提交——例如弱网超时后的重试。同一账号用相同的 key 重复提交，会返回首次创建的生成任务而不是新建一个，也不会再次扣除积分；响应中会带 deduped: true。极少数情况下会返回 409 / idempotency_conflict，换一个新 key 重试即可。

响应

boolean

请求是否被接受。

string

生成请求的唯一 ID。用此 ID 轮询状态。

string

初始状态，始终为 "processing"。

number

本次生成扣除的积分数。

string

本次生成使用的模型。

string

本次生成所请求的宽高比。默认 auto 会选择合适的比例，提交时即在此返回 —— 无需等第一次轮询，可用于在界面上按正确比例预留占位。

除一种情况外，此值都与实际产物一致：Agnes Video 2.5 Flash 的图生视频，且首帧图是我们无法预裁的来源（外部 URL 或 data: base64）—— 此时输出比例跟随你的首帧图。若该场景下构图很关键，请直接读取返回视频的实际尺寸，不要依赖此字段。

boolean

若本次响应命中了此前请求的同一个 idempotencyKey，该字段为 true——未再次扣除积分。

object

扣除后更新的积分余额。

字段	类型	描述
daily	number	剩余每日免费积分
purchased	number	剩余购买积分
unlimited	boolean	用户是否拥有无限积分

{
  "success": true,
  "generationId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "creditsUsed": 6,
  "modelId": "gpt-image-2.5",
  "aspectRatio": "1:1",
  "credits": {
    "daily": 2,
    "purchased": 50,
    "unlimited": false
  }
}

查询生成状态

GET /api/generate/v2/status/:generationId

轮询此端点以检查图片是否就绪。

响应（处理中）

{
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "imageUrl": null,
  "imageUrls": null,
  "videoUrl": null,
  "mediaType": "image",
  "error": null,
  "aspectRatio": "16:9",
  "expectedWaitSeconds": 25,
  "pollHintSeconds": 20
}

expectedWaitSeconds —— 该模型 + 分辨率的预估总等待秒数（从提交时算起）。
pollHintSeconds —— 建议还需继续轮询的秒数，会逐步归零，归零即可停止轮询。用它来驱动轮询节奏，而不要写死固定超时——参考视频续写、更高档位耗时可能明显长于普通文生视频。
这两个字段只在 status 为 "processing" 时出现。

响应（图片已完成）

{
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "imageUrl": "https://images.meigen.ai/generations/xxx.png",
  "imageUrls": ["https://images.meigen.ai/generations/xxx.png"],
  "videoUrl": null,
  "mediaType": "image",
  "error": null,
  "aspectRatio": "16:9"
}

响应（视频已完成）

{
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "imageUrl": null,
  "imageUrls": null,
  "videoUrl": "https://images.meigen.ai/generations/xxx.mp4",
  "mediaType": "video",
  "error": null,
  "aspectRatio": "16:9"
}

aspectRatio 是该次生成最终采用的比例（如果你传了 auto，这里是实际落地的值）。
mediaType 取值 image 或 video。视频生成时 imageUrl/imageUrls 为 null，反之亦然。
Midjourney V8.1 每次返回 4 张候选图片，imageUrls 包含全部候选，imageUrl 始终指向第一张。其他图片模型返回单张。

响应（失败）

{
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "failed",
  "creditsStatus": "refunded",
  "imageUrl": null,
  "imageUrls": null,
  "videoUrl": null,
  "mediaType": "image",
  "error": "Content policy violation",
  "aspectRatio": "16:9"
}

生成失败时，积分会自动退还。可通过 creditsStatus 确认退款是否落地：pending（已预扣，结果未定）、confirmed（已实际扣费）、refunded（已退回余额）。

示例

基本生成

省略 modelId 时使用当前图片默认模型。请读取模型列表的 is_default，默认值可能变化：

curl -X POST https://www.meigen.ai/api/generate/v2 \
  -H "Authorization: Bearer meigen_sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A minimalist logo of a mountain, vector style, blue gradient",
    "aspectRatio": "1:1"
  }'

显式设置 GPT Image 2.5

当活跃模型列表中返回 gpt-image-2.5 时，可使用此示例。

curl -X POST https://www.meigen.ai/api/generate/v2 \
  -H "Authorization: Bearer meigen_sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A studio product photo of a ceramic coffee mug, soft window light",
    "modelId": "gpt-image-2.5",
    "aspectRatio": "4:5",
    "resolution": "2K",
    "quality": "low",
    "modelVariant": "sunburst"
  }'

这次 2K Standard 请求消耗 6 积分。若要使用 4K Max 与速度优先，改为 resolution: "4K"、quality: "max"、modelVariant: "flare"（88 积分）。添加 referenceImages 即可编辑或使用视觉参考，不额外收取参考图积分。实扣以 creditsUsed 为准。只有重试相同请求时才复用同一个 idempotencyKey。修改质量或型号选项属于新请求，应使用新的 key。

带参考图片

curl -X POST https://www.meigen.ai/api/generate/v2 \
  -H "Authorization: Bearer meigen_sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Similar style landscape but with autumn colors",
    "modelId": "seedream-4.5",
    "aspectRatio": "16:9",
    "referenceImages": ["https://example.com/reference.jpg"]
  }'

Midjourney V8.1 风格参考

curl -X POST https://www.meigen.ai/api/generate/v2 \
  -H "Authorization: Bearer meigen_sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a warrior princess in an enchanted forest",
    "modelId": "midjourney-v8.1",
    "aspectRatio": "3:4",
    "referenceImages": ["https://example.com/style-ref.jpg"],
    "referenceType": "style",
    "niji7Options": {
      "stylize": 300,
      "sw": 500
    }
  }'

Seedance 2.5 视频生成（文生视频）

curl -X POST https://www.meigen.ai/api/generate/v2 \
  -H "Authorization: Bearer meigen_sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A majestic eagle soaring over a misty mountain valley at sunrise, cinematic camera movement",
    "modelId": "seedance-2-5",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

计费：Seedance 2.5 没有档位。720p 为 39 积分/秒 × 5 秒 = 195 积分。

Seedance 2.5 视频续写（参考视频）

curl -X POST https://www.meigen.ai/api/generate/v2 \
  -H "Authorization: Bearer meigen_sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Continue the scene as the eagle dives toward a river below",
    "modelId": "seedance-2-5",
    "aspectRatio": "adaptive",
    "resolution": "480p",
    "duration": 5,
    "referenceVideo": "https://images.meigen.ai/generations/eagle-clip.mp4"
  }'

计费：480p 带参考视频为 11 积分/秒。假设上传视频实际为 2 秒（系统自动识别），计费秒数 = max(2 + 5, 9) = 9 秒，共 99 积分。输出长度仍为 duration = 5 秒。

让系统自动选比例（Auto）

省略 aspectRatio 或显式传 "auto"，由 MeiGen 自动挑选合适比例：

curl -X POST https://www.meigen.ai/api/generate/v2 \
  -H "Authorization: Bearer meigen_sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Blog hero banner image, abstract gradient background with code snippets"
  }'

实际采用的比例会通过 aspectRatio 字段返回 —— 本次请求的响应和状态端点里都有。

概览

接口文档

生成图片或视频

请求

请求头

请求体参数

响应

查询生成状态

响应（处理中）

响应（图片已完成）

响应（视频已完成）

响应（失败）

示例

基本生成

显式设置 GPT Image 2.5

带参考图片

Midjourney V8.1 风格参考

Seedance 2.5 视频生成（文生视频）

Seedance 2.5 视频续写（参考视频）

让系统自动选比例（Auto）

​请求

​请求头

​请求体参数

​响应

​查询生成状态

​响应（处理中）

​响应（图片已完成）

​响应（视频已完成）

​响应（失败）

​示例

​基本生成

​显式设置 GPT Image 2.5

​带参考图片

​Midjourney V8.1 风格参考

​Seedance 2.5 视频生成（文生视频）

​Seedance 2.5 视频续写（参考视频）

​让系统自动选比例（Auto）

请求

请求头

请求体参数

响应

查询生成状态

响应（处理中）

响应（图片已完成）

响应（视频已完成）

响应（失败）

示例

基本生成

显式设置 GPT Image 2.5

带参考图片

Midjourney V8.1 风格参考

Seedance 2.5 视频生成（文生视频）

Seedance 2.5 视频续写（参考视频）

让系统自动选比例（Auto）