跳转到主要内容
MeiGen API 允许你以编程方式生成图片。所有端点均可通过 https://www.meigen.ai/api/ 访问。
偏好自然语言？ 如果你使用 Claude Code、Cursor 或 OpenClaw，可以试试 MCP 服务器，无需写 HTTP 代码即可生成图片。

​
认证

API 请求需要 Bearer token。有两种认证方式：

​
API Token（推荐）

使用以 meigen_sk_ 开头的 API Key。在你的账户设置中的 API Keys 下创建。 
Authorization: Bearer meigen_sk_YOUR_API_KEY
API Token 只能使用购买积分。每日免费积分不可用于 API 调用。在发起 API 请求前，请确保你的账户有购买积分。

​
Session Token

对于基于浏览器的集成，你可以使用 Supabase session access token。此方式同时使用每日积分和购买积分。

​
基础 URL

https://www.meigen.ai/api

​
请求格式

所有请求体必须以 JSON 格式发送，并设置 Content-Type: application/json 请求头。 
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", "modelId": "gemini-3-pro-image-preview"}'

​
响应格式

所有响应返回 JSON。成功响应包含 success: true 字段： 
{
  "success": true,
  "generationId": "abc-123",
  "status": "processing"
}
错误响应包含 error 字段： 
{
  "error": "Error description"
}

​
异步生成

图片生成是异步的。流程如下：
  1. 提交生成请求 → POST /api/generate/v2
  2. 轮询状态端点 → GET /api/generate/v2/status/:id
  3. 获取生成完成的图片 → GET /api/images/:id

​
轮询最佳实践

  • 推荐间隔：每 3 秒检查一次状态
  • 停止条件：当 status 为 completed 或 failed 时
  • 超时建议：图片模型建议 5 分钟后放弃，视频建议 10 分钟

​
典型生成时间

模型典型时间
Z Image Turbo~5 秒
Nanobanana 2, Seedream~15 秒
Nanobanana Pro~15 秒
GPT image1.5~20 秒
Midjourney V7 / Niji 7~60 秒
Seedance 2.0（视频）~1-3 分钟
Veo 3.1（视频）2-6 分钟

​
速率限制

API 请求受速率限制约束。如果你收到 429 Too Many Requests 响应：
  • 等待 10-30 秒后重试
  • 对重复失败实施指数退避策略
  • 具体速率限制可能因服务器负载而异

​
缓存

部分 GET 端点返回缓存响应：
端点缓存时长
GET /api/models5 分钟
GET /api/images/:id1 小时
POST 端点无缓存

​
积分

每次生成根据使用的模型消耗积分。查看模型页面了解各模型定价。
模型积分
Z Image Turbo2
GPT image1.52
Nanobanana 25
Seedream 5.0 Lite5
Seedream 4.55
Nanobanana Pro10
Midjourney V715
Niji 715
Seedance 2.0按秒（详见模型）
Veo 3.120

​
错误响应

状态码含义
400请求无效 — 参数错误
401未授权 — token 无效或缺失
402需要付费 — 积分不足
404未找到
429请求过于频繁 — 等待后重试
500服务器错误

​
端点

生成图片

POST /api/generate/v2

模型列表

GET /api/models

图片详情

GET /api/images/:id

Token 管理

POST/GET/DELETE /api/tokens