OpenAPI reference

curl 'https://open-api.mavowow.com/openapi/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import os
import requests

response = requests.get(
    "https://open-api.mavowow.com/openapi/v1/models",
    headers={
        "Authorization": f"Bearer {os.environ['MAVOWOW_API_KEY']}",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

const response = await fetch(
  "https://open-api.mavowow.com/openapi/v1/models",
  {
    headers: {
      Authorization: `Bearer ${process.env.MAVOWOW_API_KEY}`,
    },
  },
);

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

curl -X POST 'https://open-api.mavowow.com/openapi/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: image-edit-20260714-0001' \
  -d '{
    "model": "gemini-2.5-flash-image",
    "mode": "edit",
    "prompt": "Keep the subject and use a studio background",
    "count": 1,
    "image_urls": ["https://cdn.example.com/input.jpg"],
    "aspect_ratio": "16:9"
  }'

import os
import uuid
import requests

response = requests.post(
    "https://open-api.mavowow.com/openapi/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['MAVOWOW_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "model": "gemini-2.5-flash-image",
        "mode": "edit",
        "prompt": "Keep the subject and use a studio background",
        "count": 1,
        "image_urls": ["https://cdn.example.com/input.jpg"],
        "aspect_ratio": "16:9",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

import { randomUUID } from "node:crypto";

const response = await fetch(
  "https://open-api.mavowow.com/openapi/v1/images/generations",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.MAVOWOW_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": randomUUID(),
    },
    body: JSON.stringify({
      model: "gemini-2.5-flash-image",
      mode: "edit",
      prompt: "Keep the subject and use a studio background",
      count: 1,
      image_urls: ["https://cdn.example.com/input.jpg"],
      aspect_ratio: "16:9",
    }),
  },
);

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

curl -X POST 'https://open-api.mavowow.com/openapi/v1/videos/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: video-order-20260714-0001' \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "video_mode": "t2v",
    "prompt": "A slow push through a city at night",
    "duration": 10,
    "resolution": "720p",
    "ratio": "16:9"
  }'

import os
import uuid
import requests

response = requests.post(
    "https://open-api.mavowow.com/openapi/v1/videos/generations",
    headers={
        "Authorization": f"Bearer {os.environ['MAVOWOW_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "model": "doubao-seedance-2-0-260128",
        "video_mode": "t2v",
        "prompt": "A slow push through a city at night",
        "duration": 10,
        "resolution": "720p",
        "ratio": "16:9",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

import { randomUUID } from "node:crypto";

const response = await fetch(
  "https://open-api.mavowow.com/openapi/v1/videos/generations",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.MAVOWOW_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": randomUUID(),
    },
    body: JSON.stringify({
      model: "doubao-seedance-2-0-260128",
      video_mode: "t2v",
      prompt: "A slow push through a city at night",
      duration: 10,
      resolution: "720p",
      ratio: "16:9",
    }),
  },
);

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

curl 'https://open-api.mavowow.com/openapi/v1/tasks/TASK_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import os
import requests

task_id = "TASK_ID"
response = requests.get(
    f"https://open-api.mavowow.com/openapi/v1/tasks/{task_id}",
    headers={
        "Authorization": f"Bearer {os.environ['MAVOWOW_API_KEY']}",
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

const taskId = "TASK_ID";
const response = await fetch(
  `https://open-api.mavowow.com/openapi/v1/tasks/${taskId}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.MAVOWOW_API_KEY}`,
    },
  },
);

if (!response.ok) throw new Error(await response.text());
console.log(await response.json());