API protocol

Midjourney task compatibility protocol

Direct answerMidjourney depends on proxy or task plugins. Creation, polling, button actions and callbacks must use the same protocol. Tuzi /mj/submit/imagine examples are not verified OpenFox contracts.

Updated · Reviewed

Scope

Midjourney depends on proxy or task plugins. Creation, polling, button actions and callbacks must use the same protocol. Tuzi /mj/submit/imagine examples are not verified OpenFox contracts.

Select an endpoint and model

The marketplace owns exact model IDs, endpoint support, group access and prices. Similar model names do not establish identical parameters or permissions. Provider documentation explains capabilities, not whether a model is enabled or priced on this site. Complete examples and route-only references are labeled separately.

Prepare credentials and requests

Manage model keys on the Keys page and account credentials in Profile. Browser sessions, model keys and personal access tokens serve different purposes. Examples read placeholder credentials from server environment variables and contain no real account data. Confirm parameters for the chosen endpoint and channel; example values are not defaults. The API origin is https://api.openfox.vip.

Validate results and handle failures

Check HTTP status and business results together. Text requires complete output, images require actual decoding, and tasks require a successful terminal state and valid artifacts. A task identifier alone is not completion. Bound read-only retries and never automatically repeat creation. After a timeout preserve the request ID and inspect usage logs to avoid duplicate work or charges.

Pricing and maintenance

This guide does not promise fixed prices, quotas, retention periods or provider discounts. Use current marketplace prices and account permissions. An administrator must confirm new prices or unlisted models. Examples are generated from the OpenFox OpenAPI definitions; contract changes must update fields, result checks and failure handling together. Source review is not upstream business verification; this migration makes no paid model calls.

Use cases

  • Submit an imagine job and retrieve progress
  • Run upscale, variation, or edit actions on a completed job
  • Govern idempotency, output retention, and terms compliance

API protocols

  • /mj/submit/action
  • /{mode}/mj/submit/action
  • /mj/submit/shorten
  • /{mode}/mj/submit/shorten
  • /mj/submit/modal
  • /{mode}/mj/submit/modal
  • /mj/submit/imagine
  • /{mode}/mj/submit/imagine
  • /mj/submit/change
  • /{mode}/mj/submit/change
  • /mj/submit/simple-change
  • /{mode}/mj/submit/simple-change
  • /mj/submit/describe
  • /{mode}/mj/submit/describe
  • /mj/submit/blend
  • /{mode}/mj/submit/blend
  • /mj/submit/edits
  • /{mode}/mj/submit/edits
  • /mj/submit/video
  • /{mode}/mj/submit/video
  • /mj/task/{id}/fetch
  • /{mode}/mj/task/{id}/fetch
  • /mj/task/{id}/image-seed
  • /{mode}/mj/task/{id}/image-seed
  • /mj/task/list-by-condition
  • /{mode}/mj/task/list-by-condition
  • /mj/insight-face/swap
  • /{mode}/mj/insight-face/swap
  • /mj/submit/upload-discord-images
  • /{mode}/mj/submit/upload-discord-images
  • /api/mj/self

FAQ

Where can I confirm models and prices?

Use the current marketplace model IDs, endpoints and group prices.

Can I reuse another gateway endpoint directly?

No. Verify OpenFox routes, plugin contracts and authentication requirements.

Is source review a successful business test?

No. No paid calls were made; upstream availability depends on channels and permissions.

Official sources

  1. Midjourney Documentation Official
  2. Midjourney Terms of Service Official
  3. OpenFox API Official