Pembuatan Video apimart-zoe

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "apimart-zoe",
    "prompt": "Anak kucing oranye di ambang jendela menatap kamera, dengan sinar matahari dari samping dan gerakan kamera perlahan mendekat",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "apimart-zoe",
        "prompt": "Anak kucing oranye di ambang jendela menatap kamera, dengan sinar matahari dari samping dan gerakan kamera perlahan mendekat",
        "resolution": "1080p",
        "aspect_ratio": "16:9",
        "duration": 8,
        "audio": True,
        "nsfw_check": True,
        "return_last_frame": True
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "model": "apimart-zoe",
    "prompt": "Anak kucing oranye di ambang jendela menatap kamera, dengan sinar matahari dari samping dan gerakan kamera perlahan mendekat",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KZOEEXAMPLE"
    }
  ]
}

​

Pilih mode

​

Header

​

Parameter permintaan

​

Alamat dan batas kombinasi media

​

Validasi video referensi

​

Aturan kombinasi media

• Jangan kirim image_urls bersama image_with_roles. Kombinasi ini menghasilkan HTTP 400 (invalid_request_error) saat pengiriman, tanpa biaya. Alias image, images, dan image_url juga dihitung sebagai image_urls dan tidak dapat melewati batasan ini.
• Bingkai awal/akhir tidak boleh berada dalam permintaan yang sama dengan referensi gambar, video, atau audio.
• Maksimal satu bingkai awal dan satu akhir. Bingkai akhir memerlukan bingkai awal.
• Maksimal 30 gambar, 10 video, dan 10 audio referensi, dengan total maksimal 50 media.
• Pelanggaran kombinasi atau jumlah ini menghasilkan HTTP 400 secara sinkron tanpa biaya.
• omni_reference_task_type: "edit" memerlukan minimal satu video sumber (3.8 ≤ t < 30.2 detik). duration / seconds: hilangkan atau -1; aspect_ratio / size: hilangkan atau adaptive. Jangan gabungkan dengan draft: true. Auto/reference tetap menggunakan batas 2–15 detik beserta toleransinya.

​

Contoh permintaan

​

Bingkai awal dan akhir

{
  "model": "apimart-zoe",
  "prompt": "Transisi alami dari bingkai awal ke bingkai akhir dengan pencahayaan yang konsisten",
  "image_with_roles": [
    {
      "url": "https://example.com/start.jpg",
      "role": "first_frame"
    },
    {
      "url": "https://example.com/end.jpg",
      "role": "last_frame"
    }
  ],
  "duration": 6
}

​

Referensi gambar, video, dan audio

{
  "model": "apimart-zoe",
  "prompt": "Karakter pada gambar referensi bergerak alami di adegan video referensi, dengan musik mengikuti ritme visual",
  "image_urls": [
    "https://example.com/character.jpg"
  ],
  "video_urls": [
    "https://example.com/scene.mp4"
  ],
  "audio_urls": [
    "https://example.com/bgm.mp3"
  ],
  "duration": -1
}

​

Pengeditan video

{
  "model": "apimart-zoe",
  "prompt": "Ubah seluruh adegan menjadi film klasik hitam putih sambil mempertahankan gerakan kamera dan komposisi",
  "video_urls": [
    "https://example.com/source_20s.mp4"
  ],
  "omni_reference_task_type": "edit"
}

​

Bingkai terakhir, keluaran MOV, dan optimasi prompt

{
  "model": "apimart-zoe",
  "prompt": "Anak kucing oranye di ambang jendela menatap kamera, dengan sinar matahari dari samping dan gerakan kamera perlahan mendekat",
  "duration": 5,
  "return_last_frame": true,
  "output_format": "mov",
  "enhance_prompt": true
}

​

Draf → video final

1. Kirim draf dengan draft: true. Jika resolution dihilangkan, digunakan 480p; jika diberikan, hanya 480p yang didukung.

{
  "model": "apimart-zoe",
  "prompt": "Anak kucing oranye di ambang jendela menatap kamera, dengan sinar matahari dari samping dan gerakan kamera perlahan mendekat",
  "draft": true
}

2. Tunggu draf berhasil, lalu kirim task_id-nya untuk membuat video final. Cukup kirim model dan draft_task_id. Jika menyertakan resolution, gunakan 1080p.

{
  "model": "apimart-zoe",
  "draft_task_id": "task_01KZOEEXAMPLE"
}

​

Status dan hasil tugas

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01KZOEEXAMPLE \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "id": "task_01KZOEEXAMPLE",
    "status": "completed",
    "result": {
      "videos": [
        {
          "url": [
            "https://example.com/generated-video.mp4"
          ],
          "expires_at": 1794475442
        }
      ],
      "last_frame_url": "https://example.com/generated-last-frame.png"
    },
    "progress": 100,
    "completed": 1794389042
  }
}

​

Aturan penagihan

• Total durasi video referensi R: periksa tiap durasi saat pengiriman, jumlahkan, lalu bulatkan total ke bawah ke detik bulat. Tidak disesuaikan lagi.
• Tanpa video referensi: detik tertagih = D. Dengan referensi: D + max(R, ceil(D × 2/3)). ceil membulatkan ke atas ke bilangan bulat. Gunakan tarif dengan video referensi.
• Contoh: meminta 8 detik tetap memberi D = 8 meskipun hasilnya 8.2 detik. Durasi otomatis 8.5 memberi D = 9. Referensi 2.8 dan 3.8 detik dijumlahkan menjadi 6.6 sebelum dibulatkan ke bawah: R = 6.
• Draf (480p) dan video final (1080p) ditagih terpisah. Referensi draf tetap dihitung dengan durasi aslinya pada video final, tanpa unggah ulang.
• Pengiriman gagal tidak ditagih. Biaya tugas gagal dikembalikan otomatis.

​

Kesalahan umum