生成图片或视频

POST /api/generate/v2

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

请求

请求头

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

请求体参数

prompt

string

必填

要生成的图片的文本描述。

modelId

string

用于生成的模型。不传则使用平台当前默认模型（可能随平台配置变化）。从模型列表端点获取可用模型。图片模型：gpt-image-2, gemini-3-pro-image-preview, nanobanana-2, seedream-5.0-lite, seedream-4.5, midjourney-v8.1, flux2-klein, z-image-turbo视频模型：seedance-2-0, happyhorse-1.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 调用）。

aspectRatio

string

默认值:"auto"

生成媒体的宽高比。

默认 auto（推荐）：为你自动挑选合适的比例。
也可显式指定——必须是模型列表返回的 supported_ratios 之一。常见图片比例：1:1, 3:4, 4:3, 16:9, 9:16, 21:9, 5:4, 4:5。
Seedance 还接受特殊值 adaptive，按 referenceImages 或 referenceVideo 的尺寸自适应。仅在提供其中之一时才使用 adaptive；无参考时的行为未定义。

最终采用的比例会通过状态端点的 aspectRatio 字段回传。

resolution

string

输出分辨率。可用性取决于模型。不传则使用所选模型的默认分辨率。可选值取决于模型：图片模型支持 1K / 2K / 3K / 4K；视频模型支持 480p / 720p / 1080p。各模型实际支持的分辨率和默认值详见模型对比。

quality

string

默认值:"low"

仅用于 GPT Image 2.0。可选 low / medium / high。其他模型会忽略该参数。

referenceImages

string[]

用作参考的图片 URL 数组。必须是可公开访问的 HTTPS URL。最大数量按模型不同——参考模型列表的 max_reference_images 字段。Z Image Turbo 不支持参考图；Midjourney V8.1 / Happyhorse 1.0 仅支持 1 张；其他模型最多 5 张。

niji7Options

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
quality	string	`4`	`1` 或 `4`	默认 High（4 倍算力，不额外计费）

referenceType

string

默认值:"content"

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

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

duration

number

视频时长(秒)。Seedance 2.0:4-15(默认 5)。Happyhorse 1.0:3-15(默认 5)。Veo 3.1:4、6 或 8(默认 4)—— 只接受这三个值。

tier

string

支持多档位模型的画质档位。当前 Seedance 2.0 和 Veo 3.1 支持:fast(默认)或 pro。Pro 档以更高画质渲染,单价也更高 —— 完整价格矩阵见模型。

referenceVideo

string

仅用于 Seedance 2.0。用于”视频续写”模式的参考视频 URL。必须是可公开访问的 HTTPS URL（一般来自之前生成结果的 videoUrl 字段）。传该字段时计费走”有参考视频”档：480p 8 积分/秒、720p 14 积分/秒、1080p 14 积分/秒，并应用最低计费秒数（详见模型）。

referenceVideoDuration

number

仅用于 Seedance 2.0 + 参考视频续写。参考视频本身的时长（秒），与 duration 一起用于确定实际计费秒数（详见模型定价表）。传 referenceVideo 时必须同时传该字段——漏传会按 0 处理，可能导致计费明显低于预期且续写效果异常。

响应

success

boolean

请求是否被接受。

generationId

string

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

status

string

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

creditsUsed

number

本次生成扣除的积分数。

modelId

string

本次生成使用的模型。

credits

object

扣除后更新的积分余额。

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

{
  "success": true,
  "generationId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "creditsUsed": 10,
  "modelId": "gpt-image-2",
  "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"
}

响应（图片已完成）

{
  "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",
  "imageUrl": null,
  "imageUrls": null,
  "videoUrl": null,
  "mediaType": "image",
  "error": "Content policy violation",
  "aspectRatio": "16:9"
}

生成失败时，积分会自动退还。

示例

基本生成

省略 modelId 即使用默认模型（gpt-image-2）：

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"
  }'

带参考图片

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-5.0-lite",
    "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 视频生成（文生视频）

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-0",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

计费：720p × 5 秒 = 20 × 5 = 100 积分。

Seedance 视频续写（参考视频）

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-0",
    "aspectRatio": "adaptive",
    "resolution": "480p",
    "duration": 5,
    "referenceVideo": "https://images.meigen.ai/generations/eagle-clip.mp4",
    "referenceVideoDuration": 3
  }'

计费：480p 带参考视频单价 8 积分/秒，计费秒数 = max(3 + 5, 9) = 9 秒，共 72 积分。输出视频长度 = 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 字段返回。

​请求

​请求头

​请求体参数

​响应

​查询生成状态

​响应（处理中）

​响应（图片已完成）

​响应（视频已完成）

​响应（失败）

​示例

​基本生成

​带参考图片

​Midjourney V8.1 风格参考

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

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

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

请求

请求头

请求体参数

响应

查询生成状态

响应（处理中）

响应（图片已完成）

响应（视频已完成）

响应（失败）

示例

基本生成

带参考图片

Midjourney V8.1 风格参考

Seedance 视频生成（文生视频）

Seedance 视频续写（参考视频）

让系统自动选比例（Auto）