AI Product Images: Scenes, Cutouts, and Generation Tasks

https://openapi.meitu.com/design/enterprise/ai_product/materials?count=20

{
  "reqid": "example-request-id",
  "code": 0,
  "data": {
    "cursor": "cs-1-1",
    "data": [
      {
        "ai_product_type": 0,
        "alg_params": "",
        "can_image_video": 0,
        "default_name": "Example scene",
        "extra": "",
        "id": 1759202837959028,
        "is_color_scene": 0,
        "light_mode": "",
        "max_ratio": 0,
        "min_ratio": 0,
        "portrait_style_category_ids": [],
        "preview_v2": {
          "4592": {}
        },
        "prompt_id": "10893",
        "thumbnail": {
          "height": 1024,
          "url": "https://example.com/scene.jpeg",
          "width": 1024
        },
        "type": "ai_product_photo_scene",
        "v2_category_ids": [
          4592
        ],
        "v2_style_category_ids": [
          4606
        ]
      }
    ]
  }
}

{
  "url": "https://example.com/product.png"
}

{
  "reqid": "example-request-id",
  "code": 0,
  "data": {
    "url": "https://example.com/cutout.png",
    "height": 550,
    "width": 286,
    "x": 1,
    "y": 0
  }
}

{
  "url": "https://example.com/product.png",
  "material_id": "1759202837959028",
  "scene_type": 1,
  "product_category": "product",
  "canvas_w": 512,
  "canvas_h": 512
}

{
  "reqid": "example-request-id",
  "code": 0,
  "data": {
    "id": 46062184,
    "process_status": 1,
    "result_image_urls": [],
    "result_images": [],
    "scene_result_images": [],
    "result_num": 1,
    "task_ids": [
      995952
    ],
    "scene_type": 1,
    "canvas_w": 512,
    "canvas_h": 512,
    "url": "https://example.com/product.png"
  }
}

https://openapi.meitu.com/design/enterprise/ai_product/query?id=46062184

{
  "reqid": "example-request-id",
  "code": 0,
  "data": {
    "id": 46062184,
    "process_status": 2,
    "result_image_urls": [
      "https://example.com/result.jpeg"
    ],
    "result_images": [
      {
        "id": "995952-0",
        "url": "https://example.com/result.jpeg",
        "process_status": 2
      }
    ],
    "result_num": 1,
    "scene_result_images": [
      {
        "scene_id": 10023,
        "urls": [
          "https://example.com/result.jpeg"
        ],
        "process_status": 2,
        "task_id": 995952
      }
    ],
    "scene_type": 1,
    "canvas_w": 512,
    "canvas_h": 512,
    "url": "https://example.com/product.png"
  }
}

{
  "reqid": "example-request-id",
  "code": 11001,
  "message": "Missing required parameter: material_id"
}

import json

import requests
from sign_sdk import sign

def build_request(operation):
    base = "https://openapi.meitu.com/design/enterprise/ai_product/"
    options = {
        "materials": ("GET", base + "materials?count=20", None),
        "sod": ("POST", base + "sod", {
            "url": "https://example.com/product.png"
        }),
        "create": ("POST", base + "create", {
            "url": "https://example.com/product.png",
            "material_id": "1759202837959028",
            "scene_type": 1,
            "product_category": "product",
            "canvas_w": 512,
            "canvas_h": 512
        }),
        "query": ("GET", base + "query?id=46062184", None),
    }
    method, url, payload = options[operation]
    body = "" if payload is None else json.dumps(payload, ensure_ascii=True)
    headers = {sign.HeaderHost: "openapi.meitu.com"}
    if method == "POST":
        headers["Content-Type"] = "application/json"
    if operation == "sod":
        headers["X-Aigcp-Way"] = "handler"
    signer = sign.Signer("YOUR_ACCESS_KEY", "YOUR_SECRET_KEY")
    return signer.sign(url, method, headers, body)

def main():
    operation = "materials"  # materials, sod, create, query
    request = build_request(operation)
    with requests.Session() as session:
        response = session.send(
            request, timeout=(10, 60), verify=True, allow_redirects=False
        )
        print("Status:", response.status_code)
        print("Response:", response.text)

if __name__ == "__main__":
    main()

package main

import (
    "fmt"
    "io"
    "net/http"
    "time"

    "github.com/mtlab/api/signer"
)

func main() {
    operation := "materials" // materials, sod, create, query
    base := "https://openapi.meitu.com/design/enterprise/ai_product/"
    var method, url, body string
    headers := make(http.Header)
    headers.Set(signer.HeaderHost, "openapi.meitu.com")
    switch operation {
    case "materials":
        method, url = http.MethodGet, base+"materials?count=20"
    case "sod":
        method, url = http.MethodPost, base+"sod"
        body = `{"url":"https://example.com/product.png"}`
        headers.Set("X-Aigcp-Way", "handler")
    case "create":
        method, url = http.MethodPost, base+"create"
        body = `{"url":"https://example.com/product.png","material_id":"1759202837959028","scene_type":1,"product_category":"product","canvas_w":512,"canvas_h":512}`
    case "query":
        method, url = http.MethodGet, base+"query?id=46062184"
    default:
        fmt.Println("Unknown operation:", operation)
        return
    }
    if method == http.MethodPost {
        headers.Set("Content-Type", "application/json")
    }
    signObj := signer.NewSigner("YOUR_ACCESS_KEY", "YOUR_SECRET_KEY")
    req, err := signObj.Sign(url, method, headers, body)
    if err != nil {
        fmt.Println("Sign error:", err)
        return
    }
    client := &http.Client{
        Timeout: 60 * time.Second,
        CheckRedirect: func(req *http.Request, via []*http.Request) error {
            return http.ErrUseLastResponse
        },
    }
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Request error:", err)
        return
    }
    defer resp.Body.Close()
    data, err := io.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("Read error:", err)
        return
    }
    fmt.Println("Status:", resp.StatusCode)
    fmt.Println("Response:", string(data))
}

<?php
require_once __DIR__ . '/signer.php';

$operation = 'materials'; // materials, sod, create, query
$base = 'https://openapi.meitu.com/design/enterprise/ai_product/';
$options = [
    'materials' => ['GET', $base . 'materials?count=20', null],
    'sod' => ['POST', $base . 'sod', [
        'url' => 'https://example.com/product.png'
    ]],
    'create' => ['POST', $base . 'create', [
        'url' => 'https://example.com/product.png',
        'material_id' => '1759202837959028',
        'scene_type' => 1,
        'product_category' => 'product',
        'canvas_w' => 512,
        'canvas_h' => 512
    ]],
    'query' => ['GET', $base . 'query?id=46062184', null],
];
[$method, $url, $payload] = $options[$operation];
$body = $payload === null ? '' : json_encode(
    $payload, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES
);
$headers = ['Host' => 'openapi.meitu.com'];
if ($method === 'POST') {
    $headers['Content-Type'] = 'application/json';
}
if ($operation === 'sod') {
    $headers['X-Aigcp-Way'] = 'handler';
}
$signer = new Signer('YOUR_ACCESS_KEY', 'YOUR_SECRET_KEY');
$curl = $signer->sign($url, $method, $headers, $body);
if ($method === 'GET') {
    curl_setopt($curl, CURLOPT_HTTPGET, true);
}
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, false);
curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 10);
curl_setopt($curl, CURLOPT_TIMEOUT, 60);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, true);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2);
$response = curl_exec($curl);
if ($response === false) {
    echo 'Error: ' . curl_error($curl) . PHP_EOL;
} else {
    echo 'Status: ' . curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL;
    echo 'Response: ' . $response . PHP_EOL;
}
curl_close($curl);

import com.meitu.openai.common.Signer;

import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

public class Main {
    public static void main(String[] args) throws Exception {
        String operation = "materials"; // materials, sod, create, query
        String base = "https://openapi.meitu.com/design/enterprise/ai_product/";
        String method;
        String url;
        String body = "";
        Map<String, String> headers = new HashMap<>();
        headers.put(Signer.HeaderHost, "openapi.meitu.com");
        switch (operation) {
            case "materials":
                method = "GET";
                url = base + "materials?count=20";
                break;
            case "sod":
                method = "POST";
                url = base + "sod";
                body = "{\"url\":\"https://example.com/product.png\"}";
                headers.put("X-Aigcp-Way", "handler");
                break;
            case "create":
                method = "POST";
                url = base + "create";
                body = "{\"url\":\"https://example.com/product.png\",\"material_id\":\"1759202837959028\",\"scene_type\":1,\"product_category\":\"product\",\"canvas_w\":512,\"canvas_h\":512}";
                break;
            case "query":
                method = "GET";
                url = base + "query?id=46062184";
                break;
            default:
                throw new IllegalArgumentException("Unknown operation: " + operation);
        }
        if ("POST".equals(method)) {
            headers.put("Content-Type", "application/json");
        }
        Signer signer = new Signer("YOUR_ACCESS_KEY", "YOUR_SECRET_KEY");
        Map<String, String> signedHeaders = signer.sign(url, method, headers, body);
        HttpURLConnection connection = (HttpURLConnection) new URL(url).openConnection();
        try {
            connection.setRequestMethod(method);
            connection.setConnectTimeout(10000);
            connection.setReadTimeout(60000);
            connection.setInstanceFollowRedirects(false);
            for (Map.Entry<String, String> entry : signedHeaders.entrySet()) {
                connection.setRequestProperty(entry.getKey(), entry.getValue());
            }
            if ("POST".equals(method)) {
                connection.setDoOutput(true);
                byte[] bytes = body.getBytes(StandardCharsets.UTF_8);
                connection.setFixedLengthStreamingMode(bytes.length);
                try (OutputStream output = connection.getOutputStream()) {
                    output.write(bytes);
                }
            }
            int status = connection.getResponseCode();
            System.out.println("Status: " + status);
            InputStream responseStream = status >= 400
                    ? connection.getErrorStream() : connection.getInputStream();
            if (responseStream != null) {
                try (InputStream input = responseStream;
                     ByteArrayOutputStream output = new ByteArrayOutputStream()) {
                    byte[] buffer = new byte[4096];
                    int length;
                    while ((length = input.read(buffer)) != -1) {
                        output.write(buffer, 0, length);
                    }
                    System.out.println("Response: " + output.toString("UTF-8"));
                }
            }
        } finally {
            connection.disconnect();
        }
    }
}