Buat video, gambar, dan musik dari kode Anda sendiri

Tiga langkah dari nol hingga video selesai. Setiap permintaan menggunakan HTTPS biasa dengan JSON, jadi bahasa atau alat apa pun bisa digunakan.

1. 1

   Buat kunci

   Buka halaman API di akun Anda dan buat kunci. Kunci lengkap hanya ditampilkan sekali, jadi simpan di variabel lingkungan bernama API_KEY.

   Buat kunci
2. 2

   Kirim tugas

   Kirim model, prompt, dan opsi apa pun. Kredit dikenakan sekali saat pengiriman, dan respons memberi tahu berapa banyak yang digunakan dan sisa saldo.

   cURLJavaScriptPython

   Salin

   curl -X POST https://novamotions.com/api/v1/videos \
     -H "Authorization: Bearer $API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "seedance-2-pro",
       "prompt": "Pengambilan gambar dolly lambat melewati jalan neon hujan di malam hari, pantulan di aspal basah, sinematik",
       "duration": 5,
       "resolution": "720p",
       "aspect_ratio": "16:9"
     }'

3. 3

   Pantau sampai siap

   Periksa tugas setiap beberapa detik. Saat status berhasil, unduh file dari output_url. Jika gagal, kredit sudah dikembalikan ke saldo Anda.

   cURLJavaScriptPython

   Salin

   TASK_ID=your_task_id
   while true
   do
     TASK=$(curl -s https://novamotions.com/api/v1/tasks/$TASK_ID -H "Authorization: Bearer $API_KEY")
     STATUS=$(echo "$TASK" | jq -r .status)
     echo "$STATUS"
     if [ "$STATUS" = "succeeded" ] || [ "$STATUS" = "failed" ]
     then
       echo "$TASK" | jq
       break
     fi
     sleep 5
   done

Kirim kunci Anda di header Authorization setiap permintaan. Kunci dimulai dengan nm_live_ dan milik satu akun.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

URL Dasar

Semua endpoint berada di bawah https://novamotions.com/api/v1 dan mengembalikan JSON.

Jaga kerahasiaan kunci

Panggil API dari server Anda, jangan dari browser atau aplikasi seluler. Kunci yang dicabut langsung berhenti berfungsi.

Satu saldo

Panggilan API menggunakan kredit pemilik kunci, saldo yang sama dengan yang digunakan studio. Batas rencana per generasi juga berlaku.

URL Media

Gambar, video, dan audio yang Anda kirim harus berupa URL https publik yang dapat dimuat tanpa cookie atau login.

Setiap model yang disediakan API, dengan mode, durasi, resolusi, rasio aspek, dukungan audio, batas referensi, dan harga terendah dalam kredit. Gunakan ini untuk membuat pemilih model daripada mengkode opsi secara statis.

curl https://novamotions.com/api/v1/models \
  -H "Authorization: Bearer $API_KEY"

{
  "object": "list",
  "data": [
    {
      "slug": "seedance-2-pro",
      "name": "Seedance 2.0 Pro",
      "kind": "video",
      "endpoint": "/api/v1/videos",
      "available": true,
      "modes": [
        "text-to-video",
        "image-to-video",
        "reference-to-video"
      ],
      "durations": [
        4,
        5,
        6,
        8,
        10,
        12,
        15
      ],
      "default_duration": 5,
      "resolutions": [
        "480p",
        "720p",
        "1080p",
        "4K"
      ],
      "aspect_ratios": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4",
        "21:9"
      ],
      "audio": {
        "supported": true,
        "extra_credits": 20
      },
      "references": {
        "images": 9,
        "videos": 3,
        "audio": 3,
        "end_frame": true
      },
      "max_count": 4,
      "prompt_max_length": 10000,
      "from_credits": 35
    }
  ]
}

Kredit yang dapat digunakan pemilik kunci saat ini, dibagi dalam beberapa pool dengan tanggal kedaluwarsa, plus rencana saat ini.

curl https://novamotions.com/api/v1/balance \
  -H "Authorization: Bearer $API_KEY"

{
  "object": "balance",
  "balance": 1175,
  "never_expiring": 375,
  "next_expiry": "2026-11-17T00:00:00.000Z",
  "pools": [
    {
      "source": "subscription",
      "remaining": 800,
      "granted": 2000,
      "expires_at": "2026-11-17T00:00:00.000Z"
    },
    {
      "source": "topup",
      "remaining": 375,
      "granted": 375,
      "expires_at": null
    }
  ],
  "plan": {
    "name": "Pro",
    "status": "active",
    "cycle": "monthly",
    "renews_or_ends_at": "2026-11-14T00:00:00.000Z"
  }
}

Teks ke video, gambar ke video (frame awal dan opsional frame akhir), atau referensi ke video (gambar, klip, dan audio yang mengarahkan hasil). Mode dipilih dari input jika tidak disertakan.

curl -X POST https://novamotions.com/api/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-pro",
    "prompt": "Pengambilan gambar dolly lambat melewati jalan neon hujan di malam hari, pantulan di aspal basah, sinematik",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

{
  "tasks": [
    {
      "id": "cmtask8k2x0001ab7c9d0e1f2",
      "status": "queued",
      "credits": 44,
      "url": "https://novamotions.com/api/v1/tasks/cmtask8k2x0001ab7c9d0e1f2"
    }
  ],
  "credits_charged": 44,
  "balance": 1131
}

Teks ke gambar, atau edit gambar yang sudah ada dengan prompt. Minta hingga empat gambar per permintaan, masing-masing adalah tugas tersendiri.

curl -X POST https://novamotions.com/api/v1/images \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Foto produk studio dari cangkir kopi keramik di atas kayu oak, cahaya jendela lembut, kedalaman bidang dangkal",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "count": 1
  }'

{
  "tasks": [
    {
      "id": "cmtask8k2x0001ab7c9d0e1f2",
      "status": "queued",
      "credits": 3,
      "url": "https://novamotions.com/api/v1/tasks/cmtask8k2x0001ab7c9d0e1f2"
    }
  ],
  "credits_charged": 3,
  "balance": 1172
}

Lagu lengkap dari deskripsi, dengan lirik Anda sendiri atau sebagai instrumental.

curl -X POST https://novamotions.com/api/v1/music \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ai-music",
    "prompt": "Lo-fi hip hop hangat dengan piano lembut, suara vinyl berderak, dan groove santai larut malam",
    "duration": 60,
    "instrumental": false
  }'

{
  "tasks": [
    {
      "id": "cmtask8k2x0001ab7c9d0e1f2",
      "status": "queued",
      "credits": 11,
      "url": "https://novamotions.com/api/v1/tasks/cmtask8k2x0001ab7c9d0e1f2"
    }
  ],
  "credits_charged": 11,
  "balance": 1164
}

Pantau tugas berdasarkan id-nya. Setelah status berhasil, output_url menunjuk ke file selesai. Pemantauan menggunakan batas baca, jadi tidak mengurangi anggaran pengiriman Anda.

curl https://novamotions.com/api/v1/tasks/cmtask8k2x0001ab7c9d0e1f2 \
  -H "Authorization: Bearer $API_KEY"

{
  "id": "cmtask8k2x0001ab7c9d0e1f2",
  "object": "task",
  "kind": "video",
  "model": "seedance-2-pro",
  "mode": "text-to-video",
  "status": "succeeded",
  "progress": 100,
  "prompt": "Pengambilan gambar dolly lambat melewati jalan neon hujan di malam hari, pantulan di aspal basah, sinematik",
  "params": {
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": false,
    "seed": null
  },
  "output_url": "https://novamotions.com/uploads/videos/2026/10/example.mp4",
  "thumbnail_url": "https://novamotions.com/uploads/videos/2026/10/example.jpg",
  "width": 1280,
  "height": 720,
  "duration_seconds": 5,
  "credits": 44,
  "refunded": false,
  "error": null,
  "created_at": "2026-10-18T09:30:00.000Z",
  "completed_at": "2026-10-18T09:31:12.000Z"
}

Tugas yang Anda buat melalui API dalam 30 hari terakhir, terbaru di atas, dengan format yang sama seperti tugas tunggal. Kirim next_cursor sebagai cursor untuk memuat halaman berikutnya.

curl https://novamotions.com/api/v1/tasks?limit=20 \
  -H "Authorization: Bearer $API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "cmtask8k2x0001ab7c9d0e1f2",
      "object": "task",
      "kind": "video",
      "model": "seedance-2-pro",
      "mode": "text-to-video",
      "status": "succeeded",
      "progress": 100,
      "prompt": "Pengambilan gambar dolly lambat melewati jalan neon hujan di malam hari, pantulan di aspal basah, sinematik",
      "params": {
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "audio": false,
        "seed": null
      },
      "output_url": "https://novamotions.com/uploads/videos/2026/10/example.mp4",
      "thumbnail_url": "https://novamotions.com/uploads/videos/2026/10/example.jpg",
      "width": 1280,
      "height": 720,
      "duration_seconds": 5,
      "credits": 44,
      "refunded": false,
      "error": null,
      "created_at": "2026-10-18T09:30:00.000Z",
      "completed_at": "2026-10-18T09:31:12.000Z"
    }
  ],
  "next_cursor": null
}

Tugas bergerak dari queued ke running dan berakhir sebagai succeeded atau failed. Berhenti polling pada status akhir mana pun.

queued

Diterima dan menunggu slot render. Terus polling.

running

Sedang dirender. progres dari 0 sampai 99.

succeeded

Selesai. output_url dan thumbnail_url mengarah ke file jadi.

failed

Berakhir tanpa hasil. error menjelaskan alasannya dan refunded true, kredit dikembalikan ke saldo Anda.

Setiap kesalahan memiliki bentuk yang sama. Cabang berdasarkan kode dan tampilkan pesan untuk pengguna. Tugas yang diterima bisa gagal kemudian, jadi periksa status saat polling.

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this request. Top up or renew your plan, then retry.",
    "needed": 44,
    "balance": 14
  }
}

Batas dihitung per kunci selama satu menit berjalan. Jika melebihi batas, Anda mendapat HTTP 429 dengan header Retry-After dalam detik. Setiap respon membawa header X-RateLimit agar Anda bisa memperlambat sebelum mencapai batas.

Kirim

30 per menit

Membuat video, gambar, dan lagu.

Baca

120 per menit

Tugas, saldo, dan model. Dihitung terpisah dari kiriman.

Berjalan sekaligus

3

Tugas per akun yang dirender bersamaan.

HTTP/1.1 429 Too Many Requests
Retry-After: 42
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 42

Model yang dapat Anda panggil hari ini dengan slug dan harga terendahnya. Endpoint model mengembalikan daftar yang sama dengan semua opsi.