Kendi kodunuzla video, resim ve müzik oluşturun

Sıfırdan bitmiş bir videoya üç adım. Her istek JSON ile düz HTTPS olduğundan, her dil veya araç çalışır.

1. 1

   Bir anahtar oluşturun

   Hesabınızdaki API sayfasını açın ve bir anahtar oluşturun. Tam anahtar bir kez gösterilir, bu yüzden API_KEY adlı bir ortam değişkeninde saklayın.

   Anahtar oluştur
2. 2

   Bir görev gönderin

   Modeli, bir istemi ve seçenekleri gönderin. Krediler sadece gönderimde alınır ve yanıt size kaç tane kullanıldığını ve kalanını bildirir.

   cURLJavaScriptPython

   Kopyala

   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": "Gece yağmurlu neon sokakta yavaş dolly çekimi, ıslak asfaltta yansımalar, sinematik",
       "duration": 5,
       "resolution": "720p",
       "aspect_ratio": "16:9"
     }'

3. 3

   Hazır olana kadar sorgulayın

   Görevi birkaç saniyede bir kontrol edin. Durum başarılı olduğunda, dosyayı output_url’den indirin. Başarısız olursa, krediler zaten bakiyenize geri eklenmiştir.

   cURLJavaScriptPython

   Kopyala

   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

Her istekte anahtarınızı Authorization başlığında gönderin. Anahtarlar nm_live_ ile başlar ve tek bir hesaba aittir.

Authorization: Bearer nm_live_your_api_key
Content-Type: application/json

Temel URL

Tüm uç noktalar https://novamotions.com/api/v1 altında çalışır ve JSON döner.

Anahtarları gizli tutun

API’yi sunucunuzdan çağırın, asla tarayıcıdan veya mobil uygulamadan değil. İptal edilen anahtar hemen çalışmayı durdurur.

Tek bakiye

API çağrıları anahtar sahibinin kredilerini harcar, stüdyonun kullandığı aynı bakiye. Nesil başına plan limitleri de geçerlidir.

Medya URL’leri

Gönderdiğiniz resim, video ve sesler çerez veya giriş olmadan yüklenen herkese açık https URL’leri olmalıdır.

API’nin sunduğu her model, modları, süreleri, çözünürlükleri, en boy oranları, ses desteği, referans limitleri ve en düşük kredi fiyatı ile. Sabit kodlama yerine model seçici oluşturmak için kullanın.

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
    }
  ]
}

Anahtar sahibinin şu anda harcayabileceği krediler, son kullanma tarihleri ile havuzlara ayrılmış ve mevcut plan dahil.

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"
  }
}

Metinden video, resimden video (başlangıç karesi ve isteğe bağlı bitiş karesi) veya referans video (sonucu yönlendiren resimler, klipler ve ses). Mod, girdi yoksa otomatik seçilir.

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": "Gece yağmurlu neon sokakta yavaş dolly çekimi, ıslak asfaltta yansımalar, 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
}

Metinden resim veya mevcut bir resmi istemle düzenleyin. İstek başına dört adede kadar resim isteyebilirsiniz, her biri ayrı görevdir.

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": "Meşe üzerinde seramik kahve fincanının stüdyo ürün fotoğrafı, yumuşak pencere ışığı, sığ alan derinliği",
    "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
}

Bir açıklamadan tam bir şarkı, kendi sözlerinizle veya enstrümantal olarak.

curl -X POST https://novamotions.com/api/v1/music \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ai-music",
    "prompt": "Yumuşak piyano, vinil çıtırtısı ve rahat bir gece ritmi ile sıcak lo-fi hip hop",
    "duration": 60,
    "instrumental": false
  }'

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

Bir görevi kimliğiyle sorgulayın. Durum başarılı olduğunda, output_url bitmiş dosyaya işaret eder. Sorgulama okuma limitini kullanır, gönderme bütçenizi yemez.

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": "Gece yağmurlu neon sokakta yavaş dolly çekimi, ıslak asfaltta yansımalar, 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"
}

Son 30 günde API üzerinden oluşturduğunuz görevler, en yeniden en eskiye, tek görevle aynı yapıda. Sonraki sayfayı yüklemek için next_cursor’u cursor olarak geçin.

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": "Gece yağmurlu neon sokakta yavaş dolly çekimi, ıslak asfaltta yansımalar, 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
}

Bir görev queued’den running’e geçer ve succeeded veya failed ile sona erer. Son durumlarda sorgulamayı durdurun.

queued

Kabul edildi ve render sırası bekleniyor. Sorgulamaya devam edin.

running

Şu anda render ediliyor. İlerleme 0’dan 99’a gider.

succeeded

Tamamlandı. output_url ve thumbnail_url bitmiş dosyalara işaret eder.

failed

Sonuç olmadan sona erdi. error nedeni açıklar ve refunded true ise krediler bakiyenize geri döner.

Her hata aynı yapıya sahiptir. Koda göre dallanır ve kullanıcıya mesaj gösterir. Kabul edilen görevler sonradan başarısız olabilir, sorgularken durumunu kontrol edin.

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

Sınırlar anahtar başına dakikalık kaydırmalı sayılır. Limit aşılırsa HTTP 429 ve Retry-After başlığında saniye alırsınız. Her yanıtta X-RateLimit başlıkları vardır, böylece sınırdan önce yavaşlayabilirsiniz.

Gönder

Dakikada 30

Video, görüntü ve şarkı oluşturma.

Oku

Dakikada 120

Görevler, bakiye ve modeller. Gönderimlerden ayrı sayılır.

Aynı anda çalışan

3

Hesap başına aynı anda render edilen görevler.

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

Bugün çağırabileceğiniz modeller, kısa isimleri ve en düşük fiyatlarıyla. Models uç noktası aynı listeyi tüm seçeneklerle döner.