Overview

Service — Direct Engine — Accounts — API Key
New version update available from repository! New
A new version has been released with performance updates and bug fixes. Click upgrade to install without losing data.
API Key is required to communicate with the service
The API Key protects your service and accounts from unauthorized access. Paste your secret key (starting with m2a_) into the input box on the topbar and click "Save".
Total Accounts
0
Available / Healthy
0
Error / Issues
0
Disabled
0
Media Files
0

Service Connection Credentials Required for downstream clients

Use these credentials to connect Chat, Image, or Video applications compatible with OpenAI API.
Available model aliases: muse-spark (Chat & Code), muse-image (Image Generation), muse-video (Video Generation).

Recent Generation Tasks

Task ID Type Prompt Status Duration Created At
Loading...

Add Account Batch Supported

Paste the cookie string copied from muse.ai. Required cookies: hatch_sess, hatch_vml. For batch import, provide one account per line in format: label | cookie_string.

Account Pool

● Auto Keepalive Active (30m)
Direct protocol connects via encrypted Noise-XX sessions. "Test" verifies active session renewal against muse.ai.
0 selected Batch actions for selected accounts:
Label Account ID Status Expires Quota Proxy Enabled Cookies Last Used Notes Actions
Loading...

Generation Task History 0

All Chat, Image, and Video generation tasks transition through queued → processing → completed / failed.
Task ID Type Prompt Status Duration Created At Result / Error
Loading...

Media Library 0

All generated images and videos persisted to local storage. Direct media URLs require no authentication.
Loading...

Interactive Text-to-Image Test POST /v1/images/generations

Directly submits an image generation task via the native protocol. Typically returns in 10–25 seconds.

Interactive Text-to-Video Test POST /v1/videos

Creates an asynchronous video generation task. Automatically polls for completion (usually 60–120 seconds).

1. Available Model IDs

Model ID Capabilities Endpoint
muse-spark Text conversation, code generation (streaming SSE supported) POST /v1/chat/completions
muse-image Text-to-image synthesis and image edits POST /v1/images/generations
muse-video Text-to-video synthesis (async task polling) POST /v1/videos
Standard third-party aliases (e.g. gpt-4o, claude-sonnet-4, dall-e-3) are automatically mapped to the appropriate capability.

2. Chat Completions (curl)

Copycurl -X POST "BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $MUSE2API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-spark",
    "messages": [{"role": "user", "content": "Explain quicksort in Python"}],
    "stream": false
  }'

3. Image Generation (curl)

Copycurl -X POST "BASE_URL/v1/images/generations" \
  -H "Authorization: Bearer $MUSE2API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image",
    "prompt": "Futuristic skyline with flying vehicles at sunset",
    "size": "16:9",
    "response_format": "url"
  }'

4. Video Generation (curl async workflow)

Copy# 1. Initiate video generation task
curl -X POST "BASE_URL/v1/videos" \
  -H "Authorization: Bearer $MUSE2API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A serene waterfall in the jungle", "duration": 5, "size": "16:9"}'

# 2. Poll task status until status is succeeded
curl "BASE_URL/v1/videos/task_id" -H "Authorization: Bearer $MUSE2API_KEY"

5. Python openai SDK Integration

Copyfrom openai import OpenAI

client = OpenAI(base_url="http://YOUR_SERVER:18610/v1", api_key="m2a_YOUR_KEY")

# Chat completion
response = client.chat.completions.create(
    model="muse-spark",
    messages=[{"role": "user", "content": "Hello world!"}]
)
print(response.choices[0].message.content)

# Image generation
image = client.images.generate(
    model="muse-image",
    prompt="Cyberpunk neon city street"
)
print(image.data[0].url)

6. Administrative REST Endpoints

Method Path Description
GET/admin/statusService overview, pool statistics, and recent tasks
GET/admin/accountsList all registered accounts in pool
POST/admin/accountsImport accounts (single or batch format)
PATCH/admin/accounts/{id}Update account label or enable/disable state
DELETE/admin/accounts/{id}Remove an account from pool
POST/admin/accounts/{id}/testTest and verify session authentication live
POST/admin/accounts/{id}/keepalivePerform session renewal for single account
POST/admin/accounts/keepaliveExecute pool-wide background keepalive job
GET/admin/mediaList stored media artifacts
POST/admin/media/deleteBatch delete specified media files

Official Repository Updates Checking...

Comparing local deployment against the official GitHub repository...

Media Library Storage Enabled

Controls whether generated images and videos are saved to local server storage (Media Library). When turned off, media is delivered directly to API callers without taking up disk space on the server.
Status: Active (Saving to disk) · Stored Files: —

Security & API Key Management

Regenerating the API Key will invalidate the current key immediately. All downstream clients must be updated with the new key.