本文以 Midjourney 文生图 为例,演示注册 → 获取 Token → 调 API → 拿到结果的全流程。
1. 注册账号并领取额度
- 打开 platform.acedata.cloud 注册
- 进入「Midjourney」服务详情页,购买套餐或领取试用额度
- 在「凭证」标签里点击「创建凭证」,复制返回的 Token
Token 是密钥级别的字符串,不要贴到前端 / 移动端代码或公开仓库——请用环境变量或密钥管理服务。
2. 发起请求
把 Token 设到环境变量:
export ACEDATACLOUD_API_TOKEN="your-token-here"
调一次文生图:
curl https://api.acedata.cloud/midjourney/imagine \
-X POST \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A cute cat sitting on a wooden table, soft lighting"
}'
3. 读取响应
/midjourney/imagine 会等到生成完成再返回(约几十秒),所以可以直接拿到结果:
{
"success": true,
"task_id": "27a1128f-14b5-440e-a82d-510c81e6fcd4",
"image_id": "1211290228438868029",
"image_url": "https://midjourney.cdn.acedata.cloud/.../image.png",
"image_width": 1024,
"image_height": 1024,
"actions": ["upscale1", "upscale2", "variation1", "variation2", "..."]
}
image_url 就是生成的 4 格大图,可直接展示或下载
actions 列出后续可对此图执行的操作(放大、变体)
task_id 用于后续操作(例如 upscale / variation)
如果请求失败,响应会变成形如下面的错误结构(没有 success 字段):
{
"error": {
"code": "invalid_token",
"message": "The specified token is invalid or wrong."
},
"trace_id": "..."
}
完整错误码表见 响应格式。
4. 异步:长视频 / 长音乐
视频与音乐生成耗时更长,通常只先返回 task_id,结果通过轮询或 Webhook 拿。详见 异步任务模型。
5. 后续
MCP 接入
在 Claude / Cursor 里直接调用