Lewati ke konten

API pembuatan video AI

Kirim prompt, dapatkan video jadi: Yoh menulis naskah, memilih karakter yang konsisten, menambahkan suara, musik, dan teks, lalu merender MP4-nya. Atau atur sendiri setiap langkahnya: cerita, serial, klip, karakter, timeline, dan render.

Video pertamamu dalam tiga panggilan

  1. Buat key

    Masuk, buka Settings → API keys, lalu buat key dengan stories:generate dan stories:read. Key hanya ditampilkan sekali; simpan sebagai secret di sisi server. Cek key-nya:

    curl https://www.yoh.app/api/v1/credits \
      -H "Authorization: Bearer $YOH_API_KEY"
  2. Buat video

    X-Max-Generation-Credits adalah persetujuanmu: jumlah kredit maksimal yang kamu terima untuk request ini. Kalau harganya lebih tinggi, kamu mendapat HTTP 409 berisi penawaran harga dan tidak ada yang ditagih. Pakai Idempotency-Key yang sama untuk mencoba ulang dengan aman.

    curl -X POST https://www.yoh.app/api/v1/stories/generate \
      -H "Authorization: Bearer $YOH_API_KEY" \
      -H "X-Max-Generation-Credits: 500" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: my-first-video-1" \
      -d '{ "prompt": "A dragon teaches a young knight how to fly", "contentType": "cinematic_story", "aspectRatio": "16:9", "scope": "full", "renderVideo": true }'
  3. Cek job-nya

    Cek setiap 20 detik sampai statusnya completed; jawabannya berisi storyId dan videoUrl dari MP4-nya.

    curl https://www.yoh.app/api/v1/stories/jobs/JOB_ID \
      -H "Authorization: Bearer $YOH_API_KEY"

Kenapa ini bekerja dengan baik

Kontrol penuh saat kamu butuh

Buat serial dan pemerannya sekali, lalu buat episode di dalamnya; edit klip, buat ulang gambar atau video satu klip, mulai dari video yang kamu unggah sendiri, dan render timeline pilihanmu.

Biaya yang bisa diprediksi

Setiap request berbayar butuh batas kredit atau penawaran harga yang sudah diterima. Pratinjau gratis (estimate, quoteOnly, dryRun) memberi tahu harganya sebelum apa pun dimulai.

Dibuat untuk retry

Idempotency key saat pembuatan, job tahan gangguan yang bisa dicek dan dibatalkan, dan status akhir yang jelas.

Lebih suka pakai agent?

Akun dan scope yang sama bisa dipakai lewat MCP, jadi Claude atau Codex bisa memanggil Yoh untukmu.

Pertanyaan

Apakah ada API untuk membuat video AI dari teks?

Ada. POST /api/v1/stories/generate menerima prompt dan mengembalikan job; setelah selesai, kamu mendapat MP4 yang sudah dirender, lengkap dengan naskah, karakter, suara, musik, dan teks.

Bagaimana harga API-nya?

API memakai kredit Yoh yang sama dengan aplikasinya. Setiap request berbayar menyebutkan jumlah kredit maksimal yang kamu terima, dan kamu bisa tahu harga pastinya dulu dari endpoint estimasi yang gratis.

Bisakah karakter yang sama dipakai di beberapa video?

Bisa. Buat serial dengan karakternya sekali, lalu buat episode di dalamnya; setiap episode memakai pemeran yang sama.

Di mana referensi lengkapnya?

Dokumentasi mencantumkan setiap endpoint, scope, dan error, lengkap dengan playground langsung.

Referensi lengkap: Dokumentasi Yoh · Harga · OpenAPI 3.1

Cara lain untuk terhubung