提交图片生成请求。图片异步生成 — 使用状态查询端点轮询完成情况。
请求头
| Header | 值 |
|---|
| Authorization | Bearer meigen_sk_YOUR_API_KEY |
| Content-Type | application/json |
请求体参数
要生成的图片的文本描述。长度限制因模型而异（参见模型）。 modelId
string
默认值:"gemini-3-pro-image-preview"
用于生成的模型。从模型列表端点获取可用模型。可选值：nanobanana-2, gemini-3-pro-image-preview, seedream-5.0-lite, seedream-4.5, midjourney-niji7, z-image-turbo, rhart-1.5, veo-3.1 生成图片的宽高比。必须是所选模型支持的比例之一。常用值：1:1, 3:4, 4:3, 16:9, 9:16
输出分辨率。可用性取决于模型。可选值：2K, 3K, 4K, 720p
用作参考的图片 URL 数组。必须是可公开访问的 HTTPS URL。参考图片的最大数量取决于模型（0-5 张）。
仅用于 Midjourney Niji 7 模型的高级参数。对其他模型无效。| 字段 | 类型 | 默认值 | 范围 |
|---|
| stylize | number | 150 | 0-1000 |
| chaos | number | 0 | 0-100 |
| weird | number | 0 | 0-3000 |
| raw | boolean | true | — |
| iw | number | 1.5 | 0-3 |
| sref | string | — | URL 或文本 |
| sw | number | 100 | 0-1000 |
| sv | number | 4 | 1-4 |
仅用于 Niji 7。参考图片的解读方式。
content — 用作主题素材参考style — 仅提取视觉风格
扣除后更新的积分余额。| 字段 | 类型 | 描述 |
|---|
| daily | number | 剩余每日免费积分 |
| purchased | number | 剩余购买积分 |
| unlimited | boolean | 用户是否拥有无限积分 |
{
"success": true,
"generationId": "550e8400-e29b-41d4-a716-446655440000",
"status": "processing",
"creditsUsed": 5,
"modelId": "gemini-3-pro-image-preview",
"credits": {
"daily": 10,
"purchased": 50,
"unlimited": false
}
}
查询生成状态
GET /api/generate/v2/status/:generationId
响应（处理中）
{
"jobId": "550e8400-e29b-41d4-a716-446655440000",
"status": "processing",
"imageUrl": null,
"videoUrl": null,
"mediaType": "image",
"r2Key": null,
"error": null
}
响应（已完成）
{
"jobId": "550e8400-e29b-41d4-a716-446655440000",
"status": "completed",
"imageUrl": "https://images.meigen.art/generations/xxx.png",
"videoUrl": null,
"mediaType": "image",
"r2Key": "generations/xxx.png",
"error": null
}
响应（失败）
{
"jobId": "550e8400-e29b-41d4-a716-446655440000",
"status": "failed",
"imageUrl": null,
"videoUrl": null,
"mediaType": "image",
"r2Key": null,
"error": "Content policy violation"
}
基本生成
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",
"modelId": "nanobanana-2",
"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"]
}'
Niji 7 风格参考
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-niji7",
"aspectRatio": "3:4",
"referenceImages": ["https://example.com/style-ref.jpg"],
"referenceType": "style",
"niji7Options": {
"stylize": 300,
"sw": 500,
"sv": 4
}
}'
