Beyond
Beyond

Beyond Public API

Last updated

The Beyond Public API is a REST API that lets your server generate, edit, upscale and vary images, and start image-to-video or text-to-video jobs, with the same Gemini and OpenAI templates and system prompts Beyond's own Create and Edit pages use. Every call is authenticated with a bearer API key, returns a JSON envelope, and is limited to 15 generation requests per minute per key.

Beyond Public API at a glance
Base URLhttps://midjurney-create.vercel.app/api/v1
AuthenticationAuthorization: Bearer idogen_sk_… (server-to-server only)
FormatJSON in, JSON out: { success, data } or { success, error }
Rate limits15/min per key for generation; 60/min for capabilities and video polling
Image providersGemini (default), OpenAI, NVIDIA, fal
Video providersVeo (default), Seedance 2.0 via WaveSpeed, fal or poyo

How do I authenticate with the Beyond API?

Every request needs an API key created from Beyond Settings → Public API Keys. Send it as a bearer token:

Authorization: Bearer idogen_sk_...

Server-to-server only. Never call this API directly from a browser — the key would be visible to every visitor. Call it from your own backend, then serve the result to your frontend.

An invalid, missing, or revoked key returns 401.

What does a Beyond API response look like?

Every response is one of:

{ "success": true, "data": { ... } }
{ "success": false, "error": "..." }

data mirrors Beyond's own internal API response for that action (same fields as the Create/Edit pages get back).

What are the rate limits?

Per API key, not per IP:

  • generate / edit / variations / upscale / video — 15 requests/minute
  • capabilities and video status polling — 60 requests/minute

A rate-limited request returns 429 with a Retry-After header.

Who pays for generations?

By default, generations run on Beyond's own Gemini/OpenAI keys. To use your own instead, include it in the request body:

{ "config": { "prompt": "...", "openai_api_key": "sk-..." } }

Gemini: pass apiKey at the top level of the body instead of inside config.

Which endpoints does the API have?

POST/api/v1/upload

Bring your own image into the gallery at full quality (no resize/recompress) and get back an id you can pass anywhere reference_image_ids / imageId is accepted. Accepts exactly one of: a multipart file field, JSON { url }, or JSON { base64 }. Max 8MB — bigger images should use { url } since request bodies are capped around 4.5MB.

Body:

// multipart/form-data: field "file"
// or JSON:
{ "url": "https://example.com/photo.jpg" }
// or:
{ "base64": "data:image/png;base64,..." }

Example:

curl -X POST https://midjurney-create.vercel.app/api/v1/upload \
  -H "Authorization: Bearer idogen_sk_..." \
  -F "file=@photo.jpg"

# or by URL:
curl -X POST https://midjurney-create.vercel.app/api/v1/upload \
  -H "Authorization: Bearer idogen_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/photo.jpg"}'

POST/api/v1/generate

Generate an image. Supports every Create-page feature: stackable style templates, saved models, reference images/folders, providers (gemini/openai/nvidia/fal).

Body:

{
  "apiKey": "<optional Gemini key>",
  "config": {
    "prompt": "a cinematic product shot of a leather bag",
    "aspectRatio": "4:5",
    "provider": "gemini",
    "enabledTemplates": ["realistic", "studio-product"],
    "reference_image_ids": [],
    "negative_prompt": "blurry, low quality"
  }
}

Example:

curl -X POST https://midjurney-create.vercel.app/api/v1/generate \
  -H "Authorization: Bearer idogen_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"config":{"prompt":"a cinematic product shot of a leather bag","aspectRatio":"4:5"}}'

POST/api/v1/edit

Edit an existing image (gallery id or uploaded data) with a prompt.

Body:

{
  "imageId": "<gallery image id>",
  "editPrompt": "change the background to a beach at sunset",
  "config": { "provider": "gemini" }
}

Example:

curl -X POST https://midjurney-create.vercel.app/api/v1/edit \
  -H "Authorization: Bearer idogen_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"imageId":"...","editPrompt":"change the background to a beach at sunset"}'

POST/api/v1/variations

Generate 3 variations of an existing image.

Body:

{ "originalImageId": "<gallery image id>", "config": {} }

Example:

curl -X POST https://midjurney-create.vercel.app/api/v1/variations \
  -H "Authorization: Bearer idogen_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"originalImageId":"..."}'

POST/api/v1/upscale

Upscale an existing image to 2K/4K/8K.

Body:

{ "imageId": "<gallery image id>", "resolution": "4K", "enhancementMode": "both" }

Example:

curl -X POST https://midjurney-create.vercel.app/api/v1/upscale \
  -H "Authorization: Bearer idogen_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"imageId":"...","resolution":"4K"}'

POST/api/v1/video

Start an async video generation (image-to-video or text-to-video). Returns immediately with an operation_id — poll it below. provider: 'veo' (default, 16:9/9:16 only) or 'wavespeed' (recommended Seedance 2.0 host — best 1080p value)/'fal'/'poyo' (Seedance 2.0 — 3:4, 4:3, 1:1, 21:9, up to 15s, 4K).

Body:

{
  "provider": "veo",
  "imageId": "<gallery image id, optional>",
  "prompt": "the car drives off into the sunset",
  "durationSeconds": "8",
  "aspectRatio": "16:9",
  "resolution": "720p"
}

Example:

curl -X POST https://midjurney-create.vercel.app/api/v1/video \
  -H "Authorization: Bearer idogen_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"provider":"veo","prompt":"the car drives off into the sunset"}'

POST/api/v1/video/{operation_id}

Poll a video generation. Pass the SAME provider used to start it. Returns { done, status, video_url } once finished.

Body:

{ "provider": "veo" }

Example:

curl -X POST https://midjurney-create.vercel.app/api/v1/video/OPERATION_ID \
  -H "Authorization: Bearer idogen_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"provider":"veo"}'

GET/api/v1/capabilities

List supported providers, aspect ratios, style templates, and video options.

Example:

curl https://midjurney-create.vercel.app/api/v1/capabilities \
  -H "Authorization: Bearer idogen_sk_..."

Which style templates can I use?

Pass one or more in config.enabledTemplates (Gemini only):

realistic · cinematic · iphone · studio-product · editorial-fashion · anime · imperfections