Seedance 2.5

Keupayaan

Harga & kredit

Penjanaan video dicaj dalam bentuk kredit berdasarkan durasi dibilkan dalam saat. Tanpa input video, durasi dibilkan ialah durasi output; jika ada input video, ia juga merangkumi durasi video rujukan.

Jadual di bawah menunjukkan kredit yang dicaj sesaat, bukan jumlah kos keseluruhan untuk sesuatu tugas. Kadar caj bergantung pada model, resolusi output dan sama ada video rujukan disediakan dalam mod rujukan-ke-video. Sila rujuk formula dan contoh di bawah jadual untuk pengiraan jumlah kos keseluruhan.

• Tanpa input video: output dalam saat × kadar tanpa video.
• Dengan input video: (output dalam saat + durasi video rujukan yang diukur dalam saat) × kadar dengan video. Pelayan mengukur jumlah durasi video rujukan dan membundarkannya kepada saat penuh yang terdekat sebelum pengebilan.
• Rujukan imej atau audio sahaja akan menggunakan kadar tanpa video. Kadar pengebilan video rujukan hanya digunakan dalam mod rujukan-ke-video apabila rujukan video dibekalkan.

Kredit akan ditempah semasa penyerahan dan dicaj setelah tugasan berjaya. Tugasan yang gagal atau tamat masa akan memasuki aliran bayaran balik. Status pengebilan refund_failed bermakna bayaran balik tidak dapat diselesaikan; sila semak log API atau hubungi sokongan.

Pengesahan

Cipta kunci API dalam papan pemuka. Kunci lengkap hanya akan dipaparkan sekali sahaja. Simpan kunci ini pada pelayan anda dan hantarkannya sebagai token Bearer dalam setiap permintaan.

https://api.seevio.ai

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Tetapkan pemboleh ubah persekitaran SEEVIO_API_KEY sebelum menjalankan contoh ini. Contoh JavaScript dijalankan pada pelayan anda dengan Node.js; contoh Python menggunakan pakej requests.

Mula cepat

Hantar permintaan ringkas ini, simpan taskId yang dikembalikan, kemudian gunakan contoh pertanyaan tugasan di bawah. Nilai kredit dalam respons penciptaan ialah amaun yang ditempah.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Contoh respons cipta tugasan

Selepas permintaan di atas diterima, API akan mengembalikan respons JSON ini. taskId ialah pengecam tugasan yang digunakan untuk pertanyaan status seterusnya; credits pula ialah jumlah kredit yang dikuntukkan bagi tugasan ini. Respons ini hanya mengesahkan penciptaan tugasan dan tidak bermakna video tersebut sudah sedia. Anda perlu menyemak status tugasan secara berkala atau menggunakan Webhook untuk menerima hasil video.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 100
}

Cipta tugasan

Hantar objek JSON yang mengandungi model dan input, serta callback_url pilihan. Sentiasa nyatakan ID model tepat yang dipaparkan pada halaman ini; jika model diabaikan, ia akan memilih seedance-2-0 secara lalai.

Badan permintaan

Parameter input

Sediakan image_urls, video_urls dan audio_urls sebagai tatasusunan rentetan URL (string[]). Setiap URL yang diberikan mestilah boleh diakses secara terbuka melalui HTTPS, termasuk media yang diabaikan oleh mod yang dipilih.

Medan boolean mestilah bernilai JSON true atau false, bukannya dalam bentuk rentetan atau nombor.

Respons cipta

HTTP 200 mengembalikan taskId (rentetan) dan credits (nombor). Ini menunjukkan tugasan telah berjaya dicipta, bukan diselesaikan. Amaun di bawah sepadan dengan contoh mula cepat 720p selama 5 saat.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 100
}

Mod penjanaan & contoh

Teks ke video

Jana daripada prom teks. URL media tidak akan dihantar dalam mod ini.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Bingkai pertama

Sediakan satu imej sebagai bingkai pertama, kemudian huraikan pergerakan dalam prom anda.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Bingkai pertama dan terakhir

Sediakan dua URL imej mengikut urutan: bingkai pertama, diikuti bingkai terakhir. Contoh ini juga meminta bingkai terakhir video yang dijana.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "aspect_ratio": "adaptive",
    "return_last_frame": true
  }
}'

Rujukan multimodal

Gabungkan rujukan imej, video dan audio. Prom masih tetap diperlukan. Input video rujukan akan mengubah formula pengebilan.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "image_urls": [
      "https://example.com/character.jpg"
    ],
    "video_urls": [
      "https://example.com/camera.mp4"
    ],
    "audio_urls": [
      "https://example.com/ambience.mp3"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Rujukan audio

Gunakan audio sebagai satu-satunya jenis rujukan, berserta prom teks wajib yang menghuraikan video yang diingini.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "audio_urls": [
      "https://example.com/music.mp3"
    ]
  }
}'

Penyuntingan video

Huraikan suntingan yang diingini dan sediakan video sumber. Tetapkan duration=-1 dan gunakan nisbah aspek adaptive. Gunakan klip sumber berdurasi sekurang-kurangnya 4 saat untuk aliran kerja ini. Peraturan pengebilan untuk duration=-1 ditunjukkan di atas.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
    "duration": -1,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Pelanjutan video

Huraikan bagaimana video sumber harus diteruskan. Gunakan nisbah aspek adaptive dan tetapkan durasi output normal dalam julat model.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
    "duration": 8,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Tanya status tugasan

Gantikan ID contoh dengan taskId yang dikembalikan semasa penciptaan. Pertanyaan hanya mengembalikan tugasan milik pengguna kunci API tersebut; ID yang tidak boleh diakses atau tidak dikenali akan mengembalikan ralat HTTP 404.

Lakukan pengundian (polling) setiap 10–20 saat sebagai permulaan, kurangkan kekerapan jika menerima ralat HTTP 429, dan hentikan apabila status bertukar kepada completed atau failed. Sebaik-baiknya gunakan webhook untuk persekitaran pengeluaran. Setiap contoh kod di bawah melakukan satu pertanyaan.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"

Tugasan selesai: respons pertanyaan dengan hasil video

Apabila pertanyaan mengembalikan status=completed, ini bermakna penjanaan video telah selesai. Baca URL video daripada data.results dan muat turun video tersebut sebelum data.video_expires_at. billing_status=charged menunjukkan bahawa kredit yang diketepikan telah ditolak.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "completed",
  "billing_status": "charged",
  "credits": 100,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Tugasan gagal: respons pertanyaan dengan butiran kegagalan dan pengebilan

Apabila pertanyaan mengembalikan status=failed, ini bermakna penjanaan telah tamat tetapi gagal. Rujuk failed_reason untuk mengetahui punca kegagalan dan billing_status untuk status bayaran balik. Dalam contoh ini, refunded bermakna kredit telah dikembalikan semula. credits mengekalkan amaun asal yang diketepikan, dan respons ini tidak mengandungi data.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "failed",
  "billing_status": "refunded",
  "credits": 100,
  "failed_reason": "provider_failed"
}

Webhook

Tetapkan callback_url dalam permintaan cipta untuk menerima POST JSON apabila tugasan selesai atau gagal. Kembalikan respons 2xx dalam masa 15 saat. Penghantaran yang gagal akan dicuba semula; proses penghantaran berulang secara idempotensi menggunakan ID tugasan.

Pangkalan akhir (endpoint) panggilan balik anda mesti menerima permintaan POST dengan badan permintaan JSON (Content-Type: application/json).

Cipta tugasan dengan panggilan semula

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

Muatan webhook berbeza daripada respons pertanyaan tugasan: ia mengabaikan billing_status dan credits; butiran kegagalan berada di dalam data.failed_reason dan data.credits_refunded. Nilai created_at webhook ialah masa penciptaan acara dalam saat Unix.

Tugasan selesai: muatan panggilan balik yang berjaya

Apabila penjanaan berjaya, panggilan balik akan mengandungi status=completed. Gunakan id untuk mengenal pasti tugasan dan data.results untuk mendapatkan URL video. Muat turun dan simpan keputusan sebelum data.video_expires_at.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "completed",
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Tugasan gagal: muatan panggilan balik yang gagal

Apabila penjanaan gagal, panggilan balik akan mengandungi status=failed. Gunakan id untuk mengenal pasti tugasan, data.failed_reason untuk mengetahui punca kegagalan dan data.credits_refunded untuk jumlah kredit yang dikembalikan.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "failed",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 100
  }
}

Contoh penerima

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrls = callbackData.data.results;
    // Save the video URLs and mark this task as completed in your application.
    console.log(callbackData.id, videoUrls);
  }

  if (callbackData.status === "failed") {
    const { failed_reason, credits_refunded } = callbackData.data;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

  return new Response(null, { status: 200 });
}

Contoh Next.js ini membaca badan panggilan balik JSON dan mengendalikan tugasan yang selesai serta gagal secara terus. Tambahkan fungsi persistensi dan penyahduplikasian ID tugasan untuk aplikasi anda; masukkan kerja yang lambat ke dalam giliran (queue) sebelum mengesahkan panggilan balik.

Keperluan & had media

• Semua URL media dan panggilan semula mestilah URL HTTPS awam. Elakkan localhost, IP peribadi dan fail yang memerlukan kuki atau log masuk. URL video/audio rujukan mestilah merujuk terus kepada media yang boleh dibaca.
• Dalam rujukan-ke-video, sediakan sekurang-kurangnya satu rujukan, dengan tidak lebih daripada 30 imej, 10 video, 10 fail audio dan gabungan 50 bahan rujukan. Jumlah durasi video dan jumlah durasi audio masing-masing mestilah tidak melebihi 30 saat.
• text-to-video mengabaikan semua rujukan media. image-to-video hanya menghantar imej bingkai pertama/terakhir dan mengabaikan rujukan video serta audio. Gunakan reference-to-video untuk menggabungkan media.
• Setiap video rujukan dan fail audio mestilah berdurasi 2–30 saat. Untuk contoh penyuntingan video, gunakan klip sumber berdurasi sekurang-kurangnya 4 saat.

Ralat

Ralat HTTP mengandungi objek ralat dengan kod dan mesej. Tugasan yang berjaya diterima masih boleh gagal kemudian; tanya status tugasan atau kendalikan panggilan semula kegagalannya.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

Had kadar

Cipta tugasan: setiap kunci API membenarkan sehingga 100 permintaan seminit secara lalai. Had kadar tersuai tidak ditawarkan buat masa ini.

Kueri tugasan: setiap kunci API membenarkan sehingga 120 permintaan seminit secara lalai. Permintaan kueri dan permintaan penciptaan tugasan dikira secara berasingan.