Get App details

GET/openapi/v1/apps/{appId}

GET /openapi/v1/apps/{appId}
Authorization: Bearer <API_KEY>

Request parameters

Parameter	Location	Type	Required	Description
`appId`	Path	`string`	Yes	App ID

appId is the string returned by List published Apps, or one provided by the platform or App publisher. If the App does not exist, is unavailable, or cannot be accessed by the current account, the API returns APP_NOT_FOUND.

The success status is HTTP 200.

Success response example

{

"code": 200,

"message": "success",

"data": {

"schemaVersion": 1,

"appId": "APP_ID",

"name": "Fashion Video Generator",

"description": "Generate a video from a character reference and prompt",

"publishVersion": 3,

"estimatedPrice": "3.25000000",

"inputs": [

{

"key": "prompt",

"name": "Prompt",

"description": "Describe the video to generate",

"type": "text",

"required": true,

"defaultValue": "A cinematic fashion video"

{

"key": "reference_image",

"name": "Character reference",

"description": "Used to preserve the character's appearance",

"type": "image",

"required": true

}

"outputs": [

{

"key": "final_video",

"name": "Final video",

"description": "The generated video",

"type": "video"

}

"steps": [

{

"stepIndex": 0,

"nodeKey": "node-character-image",

"nodeType": "image",

"name": "Generate character image",

"estimatedPrice": "1.86040938"

{

"stepIndex": 1,

"nodeKey": "node-video",

"nodeType": "video",

"name": "Generate video",

"estimatedPrice": "1.38959062"

}

"examples": {

"inputJson": {

"prompt": "A cinematic fashion video",

"reference_image": {

"url": "https://example.com/ref.png"

}

"inputPreview": {

"url": "https://example.com/in.png",

"thumbnailUrl": "https://example.com/in-sm.png",

"mimeType": "image/png",

"width": 1024,

"height": 1024

"outputPreview": {

"url": "https://example.com/out.mp4",

"thumbnailUrl": "https://example.com/out.jpg",

"mimeType": "video/mp4",

"width": 1080,

"height": 1920

}

integerProtocol field, currently fixed at 200

stringFixed at success on success

objectPublic details of the App's current published version

integerVersion of the public App details schema, currently 1

stringApp ID

stringApp name

stringDescription of the App's purpose

integerCurrent published version

decimal stringEstimated Credit price of the current version, with exactly 8 decimal places

arrayInputs declared by the current published version

stringParameter key to place in inputJson when creating a Run

stringDisplay name of the input

stringInput description

stringInput type: text, image, video, or audio

booleanWhether the input is required

stringPublic default declared by the publisher; omitted when not declared

stringParameter key to place in inputJson when creating a Run

stringDisplay name of the input

stringInput description

stringInput type: text, image, video, or audio

booleanWhether the input is required

arrayFinal outputs declared by the current published version

stringOutput key

stringDisplay name of the output

stringOutput description

stringOutput type: text, image, video, or audio

arrayPublic execution steps declared by the current published version

integerStep order, starting at 0

stringStable identifier used to associate a step within the current published version

stringStep type

stringStep display name

decimal stringEstimated Credit price of the step, with exactly 8 decimal places

integerStep order, starting at 0

stringStable identifier used to associate a step within the current published version

stringStep type

stringStep display name

decimal stringEstimated Credit price of the step, with exactly 8 decimal places

objectInput and result examples provided by the publisher

objectComplete input example that can be used as the starting point for a Run

stringText input value for the example App

objectMedia input object for the example App

stringAbsolute HTTPS URL of the example media

objectInput preview media; omitted when not configured

stringOriginal input preview URL

stringInput preview thumbnail URL

stringInput preview MIME type

integerInput preview width in pixels

integerInput preview height in pixels

objectOutput preview media; omitted when not configured

stringOriginal output preview URL

stringOutput preview thumbnail URL

stringOutput preview MIME type

integerOutput preview width in pixels

integerOutput preview height in pixels

publishVersion identifies the current published version represented by these details; it may change after republishing.
steps[].nodeKey associates App detail steps with Run results. It is stable only for the current appId and publishVersion, and must not be used as an authorization credential or resource access parameter.
inputs[].defaultValue is returned only when the publisher declared a public default.
examples.inputJson can be used directly as the starting point for a Run. Without an explicit example, the server generates one only from safe defaults and it may be empty.
inputPreview and outputPreview are omitted when not configured.

Code examples

Replace REPLACE_WITH_YOUR_APP_ID with an App ID obtained from the MaxDay App Store. The examples below use the MAXDAY_API_KEY environment variable.

curl --fail-with-body \
  "https://api.maxday.ai/bio/dramas/v1/openapi/v1/apps/REPLACE_WITH_YOUR_APP_ID" \
  --header "Authorization: Bearer ${MAXDAY_API_KEY}"

const appId = "REPLACE_WITH_YOUR_APP_ID";
const response = await fetch(`https://api.maxday.ai/bio/dramas/v1/openapi/v1/apps/${appId}`, {
  headers: {
    Authorization: `Bearer ${process.env.MAXDAY_API_KEY}`,
  },
});
const body = await response.json();

if (!response.ok || body.message !== "success") {
  throw new Error(body.data?.error?.message || body.message || `HTTP ${response.status}`);
}
console.log(body.data);

import json
import os
from urllib.request import Request, urlopen

app_id = "REPLACE_WITH_YOUR_APP_ID"
request = Request(
    "https://api.maxday.ai/bio/dramas/v1/openapi/v1/apps/" + app_id,
    headers={"Authorization": "Bearer " + os.environ["MAXDAY_API_KEY"]},
)

with urlopen(request, timeout=60) as response:
    body = json.load(response)

if body.get("message") != "success":
    error = body.get("data", {}).get("error", {})
    raise RuntimeError(error.get("message") or body.get("message"))
print(json.dumps(body["data"], ensure_ascii=False, indent=2))

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public final class GetAppExample {
  public static void main(String[] args) throws Exception {
    String appId = "REPLACE_WITH_YOUR_APP_ID";
    ObjectMapper json = new ObjectMapper();
    HttpRequest request = HttpRequest.newBuilder(
            URI.create("https://api.maxday.ai/bio/dramas/v1/openapi/v1/apps/" + appId))
        .header("Authorization", "Bearer " + System.getenv("MAXDAY_API_KEY"))
        .GET()
        .build();
    HttpResponse<String> response = HttpClient.newHttpClient().send(
        request,
        HttpResponse.BodyHandlers.ofString()
    );
    JsonNode body = json.readTree(response.body());

    if (response.statusCode() < 200 || response.statusCode() >= 300
        || !"success".equals(body.path("message").asText())) {
      throw new IllegalStateException(
          body.path("data").path("error").path("message").asText(
              body.path("message").asText("HTTP " + response.statusCode())
          )
      );
    }
    System.out.println(body.path("data").toPrettyString());
  }
}