Quickstart

This walkthrough uses Midjourney text-to-image as the example: sign up → get a Token → call the API → read the result.

Register at platform.acedata.cloud
Open the Midjourney service detail page and purchase a package or claim a trial
On the Credentials tab, click Create and copy the returned Token

The Token is a secret. Never paste it into frontend / mobile code or public repos — use env vars or a secrets manager.

2. Make the request

Export your Token:

export ACEDATACLOUD_API_TOKEN="your-token-here"

Call text-to-image:

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

import os, requests

resp = requests.post(
    "https://api.acedata.cloud/midjourney/imagine",
    headers={
        "Authorization": f"Bearer {os.environ['ACEDATACLOUD_API_TOKEN']}",
        "Content-Type": "application/json",
    },
    json={"prompt": "A cute cat sitting on a wooden table, soft lighting"},
    timeout=300,
)
print(resp.json())

const res = await fetch("https://api.acedata.cloud/midjourney/imagine", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.ACEDATACLOUD_API_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    prompt: "A cute cat sitting on a wooden table, soft lighting",
  }),
});
console.log(await res.json());

3. Parse the response

/midjourney/imagine waits for generation to finish before returning (~tens of seconds), so the body already contains the result:

{
  "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 is the 4-quadrant grid image — display or download it directly
actions lists follow-up operations you can run on this image (upscale, variations)
task_id is used for follow-up calls (upscale / variation)

On failure the body shape is different — it has no success field:

{
  "error": {
    "code": "invalid_token",
    "message": "The specified token is invalid or wrong."
  },
  "trace_id": "..."
}

For the full error table see Response format.

4. Async: long video / long music

Heavier video and music endpoints typically return only a task_id and deliver the result via polling or webhook. See Async task model.

5. Where to go next

API reference

Interactive docs for every endpoint

Gateway & auth

Tokens, endpoints, error codes

Pricing overview

Billing model for each category

MCP integration

Call from Claude / Cursor directly

Getting Started

Core Concepts

AI Chat

AI Image

AI Video

AI Audio

Web & Data

CAPTCHA

Identity

Proxy

Advanced

2. Make the request

3. Parse the response

4. Async: long video / long music

5. Where to go next

API reference

Gateway & auth

Pricing overview

MCP integration

​1. Sign up and grab credit

​2. Make the request

​3. Parse the response

​4. Async: long video / long music

​5. Where to go next

API reference

Gateway & auth

Pricing overview

MCP integration

1. Sign up and grab credit

2. Make the request

3. Parse the response

4. Async: long video / long music

5. Where to go next