List engines
The engines and video models you can use, what each costs, and what each can do.
GET/v2/enginesRead prices from this endpoint rather than hard-coding them. Studio and the API price every engine and edit from one list, so an option that costs more in Studio costs more here too. Prices are in API credits. The example shows one engine and one video model; the answer lists them all.
available is false for an engine or video model your account cannot use yet: some need an account that has topped up its API wallet.
Headers
AuthorizationstringRequiredBearer mk_live_…: your API key. See Authentication.
Response
On success (200): Every engine, primary first. The JSON is { "success": true, "data": … }, and inside data:
enginesobject[]Required- Every render engine, current and legacy.
Fields of each item (8)
idstringRequired- The id to send as
engine. namestringRequired- Its mnml name, which
enginealso takes. tierstringRequiredprimaryfor a current engine,legacyfor an earlier one kept for older work.primarylegacydefaultbooleanRequired- True for the engine a render uses when it names none.
paid_onlybooleanRequired- True when the engine needs an account that has topped up its API wallet.
availablebooleanRequired- Whether this key’s account can use it now.
pricesobjectRequired- What each call costs.
Fields (2)
render_usdnumberRequired- One render, in US dollars.
edit_usdnumberRequired- One edit on this engine, in US dollars.
capabilitiesobjectRequired- What the engine can do.
Fields (4)
text_to_renderbooleanRequired- Renders from a prompt alone, with no image.
masksbooleanRequired- Takes an area for an edit: a
regionor a mask. edit_referencesbooleanRequired- Takes
referenceson an edit as well as a render. max_referencesintegerRequired- The most
referencesone call can send it.
video_modelsobject[]Required- Every video model.
Fields of each item (5)
idstringRequired- The id to send as
model. namestringRequired- Its mnml name, which
modelalso takes. defaultbooleanRequired- True for the model a video uses when it names none.
availablebooleanRequired- Whether this key’s account can use it now. Video needs an account that has paid.
pricesobject[]Required- What a clip costs, by length.
Fields of each item (2)
duration_secondsinteger | nullRequired- The clip length to send as
duration_seconds;nullfor a model with one fixed length. usdnumberRequired- The price of one clip of that length, in US dollars.
Response headers (4)
X-Request-Idstring- This request, for support and the console log.
RateLimit-Limitinteger- Requests this key may make per minute.
RateLimit-Remaininginteger- Requests left in the current minute.
RateLimit-Resetinteger- Seconds until the current minute resets.
Status codes
- 200
- Every engine, primary first.
- 401
- The API key is missing, malformed, unknown or revoked.
- 429
- A limit was reached: requests per minute, or a daily or concurrency limit.
- Other
- Any other error, in the same envelope.
Every error answers { "success": false, "error": { "code", "message" } }. What each code means, and what to do, is on Errors.