跳转到主要内容
MeiGen 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

面向 meigen.ai 内部的浏览器集成，使用登录后的 session access token。每日免费积分仅可用于基础模型（当前为 Z Image Turbo）；高级模型始终需要消耗注册赠送或购买积分。第三方集成请统一使用上面的 API 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": "gpt-image-2"}'

​
响应格式

所有响应返回 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. 当 status === "completed" 时，直接从状态响应读取 imageUrl / imageUrls / videoUrl。

​
轮询最佳实践

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

​
速率限制

POST /api/generate/v2 限速 每用户每分钟 12 次。超出后返回 429 Too Many Requests，响应头会带：
  • Retry-After: 60
  • X-RateLimit-Limit: 12
  • X-RateLimit-Remaining: 0
收到 429 时请按 Retry-After 等待；连续失败时叠加指数退避。

​
缓存

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

​
积分

每次生成会从账户扣除积分。图片模型按张固定收费，Seedance 2.0 按秒计费。各模型完整定价表见模型页面。

​
错误响应

状态码含义
400请求无效 — 参数错误
401未授权 — token 无效或缺失
402需要付费 — 积分不足
404未找到
429请求过于频繁 — 等待后重试
500服务器错误
POST /api/generate/v2 在 400 / 402 时还会附带便于排查的额外字段： 
// 400 — 比例不被该模型支持
{
  "success": false,
  "error": "Aspect ratio 32:9 not supported by this model",
  "supportedRatios": ["1:1", "3:2", "2:3", "16:9", "9:16", "4:3", "3:4", "5:4", "4:5", "21:9", "9:21"]
}

// 402 — 积分不足
{
  "success": false,
  "error": "Insufficient credits",
  "required": 10,
  "available": 4
}

​
端点

生成图片

POST /api/generate/v2

模型列表

GET /api/models

图片详情

GET /api/images/:id

Token 管理

POST/GET/DELETE /api/tokens