API Hop

दस्तावेज़

API Hop दस्तावेज़

Seedance 2.5 वीडियो जनरेशन

Seedance 2.5 की मल्टीमोडल सामग्री, जनरेट किया ऑडियो और draft-task पुनःउपयोग पैरामीटर।

POSThttps://api.apihop.ai/v1/video/seedance

असिंक्रोनस Seedance 2.5 जॉब बनाएँ। Seedance 2.0 के लिए उसका अलग पैरामीटर संदर्भ लें।

प्रमाणीकरण

http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

अनुरोध बॉडी

modelstringआवश्यक

seedance-2.5.

promptstring

वीडियो प्रॉम्प्ट। केवल टेक्स्ट जनरेशन में आवश्यक; चित्र/वीडियो संदर्भ हों तो छोड़ा या खाली रखा जा सकता है। draft_task पुनःउपयोग में छोड़ें। metadata.content के टेक्स्ट आइटम हटते हैं; शीर्ष-स्तरीय prompt प्रामाणिक है।

durationnumberडिफ़ॉल्ट: 5

4 से 30 तक पूर्णांक या स्वचालित अवधि के लिए -1। मूल seconds बराबर पूर्णांक स्ट्रिंग स्वीकार करता है। metadata.duration भी स्वीकार है। दिए गए अवधि उपनाम समान होने चाहिए। draft_task पुनःउपयोग में सभी अवधि नियंत्रण छोड़ें।

resolutionstringडिफ़ॉल्ट: 720p

480p, 720p या 1080p। मूल size रिज़ॉल्यूशन बता सकता है; metadata.resolution को प्राथमिकता है। 4k समर्थित नहीं।

aspectRatiostringडिफ़ॉल्ट: 16:9

16:9, 9:16, 1:1, 4:3, 3:4, 21:9 या adaptive। aspect_ratio, ratio और metadata.ratio स्वीकार हैं। संगतता के लिए size में पुराने अनुपात मान स्वीकार रहते हैं, लेकिन size का रिज़ॉल्यूशन मान रिज़ॉल्यूशन ही है। पहले/अंतिम फ़्रेम इनपुट में adaptive चाहिए; फ़्रेम भूमिकाएँ हों और स्पष्ट अनुपात न हो तो यह चुना जाता है।

metadataobject

resolution, ratio, duration, content, generate_audio और output_format स्वीकार हैं। जनरेट किए ऑडियो के लिए generate_audio बूलियन दें। शीर्ष-स्तरीय generateAudio / generate_audio उपनाम हैं; केवल एक ऑडियो नियंत्रण लें।

imageUrlsstring[]

संदर्भ चित्र। images, imageUrl, image_urls और image_url उपनाम हैं। मूल images संक्षिप्त रूप में पहले दो चित्र पहले/अंतिम फ़्रेम बनते हैं; imageUrls संदर्भ-चित्र अर्थ बनाए रखता है।

imageWithRolesobject[]

url और role वाले भूमिका-आधारित चित्र: first_frame, last_frame या reference_image। image_with_roles उपनाम है। प्रकार-निर्धारित metadata.content भी स्वीकार है।

videoUrlsstring[]

संदर्भ वीडियो। videoUrl, video_urls और video_url उपनाम हैं।

audioUrlsstring[]

संदर्भ ऑडियो। audioUrl, audio_urls और audio_url उपनाम हैं। उसी अनुरोध में चित्र या वीडियो चाहिए।

outputFormatstringडिफ़ॉल्ट: mp4

केवल mp4। output_format और metadata.output_format स्वीकार हैं। mov और watermark समर्थित नहीं।

callback_urlstring

वैकल्पिक मूल callback URL। उपलब्धता चुने चैनल पर निर्भर है; प्रामाणिक परिणाम के लिए GET https://api.apihop.ai/v1/jobs/{jobId} लें।

मल्टीमोडल सामग्री

मीडिया URL में सार्वजनिक HTTP(S) URL या मौजूदा asset:// पहचान इस्तेमाल कर सकते हैं।

प्रकारनेस्टेड फ़ील्डभूमिकाएँ
image_urlimage_url.urlfirst_frame, last_frame, reference_image
video_urlvideo_url.urlreference_video
audio_urlaudio_url.urlreference_audio
draft_taskdraft_task.idभूमिका नहीं; केवल नमूना पुनःउपयोग

संक्षिप्त और प्रकार-निर्धारित सामग्री में कुल अधिकतम 50 मीडिया आइटम के भीतर 30 चित्र, 10 वीडियो और 10 ऑडियो फ़ाइल स्वीकार हैं। ऑडियो के साथ चित्र या वीडियो चाहिए। type: "text" सामग्री के बजाय शीर्ष-स्तरीय prompt लें। हर सेटिंग के लिए केवल एक उपनाम दें। असमर्थित नियंत्रण अस्वीकार होते हैं। शीर्ष-स्तरीय first_frame_url, last_frame_url, reference_image_urls, reference_video_urls और reference_audio_urls भूमिका-विशिष्ट संक्षिप्त रूप हैं। सामग्री आइटम के सूची से बाहर फ़ील्ड आगे नहीं भेजे जाते।

ड्राफ़्ट कार्य का पुनःउपयोग

draft_task केवल Seedance 2.5 में है। यह मौजूदा संगत पूरे नमूने का पुनःउपयोग करता है; यह पृष्ठ नमूना बनाने के नियंत्रण परिभाषित नहीं करता।

  • metadata.content में ठीक एक draft_task आइटम होना चाहिए।
  • draft_task.id में मौजूदा नमूने की Synapse दशमलव-स्ट्रिंग jobId प्राथमिकता दें।

पहले से दर्ज प्लेटफ़ॉर्म task_... पहचान भी स्वीकार है; अपस्ट्रीम की कच्ची कार्य ID इस्तेमाल न करें और पहचान न गढ़ें।

  • नमूना उसी खाते का हो, वही मॉडल और संसाधन चैनल इस्तेमाल करे, पूरा हो और

उसे बने 7 दिन से कम हुए हों।

  • प्रॉम्प्ट, चित्र/वीडियो/ऑडियो इनपुट, अवधि, अनुपात, seed, generate_audio, आउटपुट

प्रारूप या omni_reference_task_type न दें। नमूने की सेटिंग दोबारा इस्तेमाल होती हैं।

  • आउटपुट रिज़ॉल्यूशन दे सकते हैं।

संदर्भित कार्य सफलतापूर्वक पूरा होने पर भी संगतता और स्वामित्व जाँच पुनःउपयोग अस्वीकार कर सकती हैं। हर सामान्य जनरेशन को पुनःउपयोग योग्य नमूना न मानें।

अनुरोध उदाहरण

मल्टीमोडल संदर्भ

json
{
  "model": "seedance-2.5",
  "prompt": "Keep the referenced character and camera movement in a coherent film",
  "seconds": "8",
  "size": "720p",
  "metadata": {
    "ratio": "16:9",
    "generate_audio": true,
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/character.png"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://example.com/camera.mp4"}, "role": "reference_video"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/music.mp3"}, "role": "reference_audio"}
    ]
  }
}

पहला और अंतिम फ़्रेम

json
{
  "model": "seedance-2.5",
  "duration": 5,
  "metadata": {
    "ratio": "adaptive",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
      {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"}
    ]
  }
}

मौजूदा नमूना दोबारा इस्तेमाल करें

EXISTING_SAMPLE_JOB_ID को वास्तविक संगत पूरे नमूने की लौटी jobId से बदलें। नीचे का प्लेसहोल्डर काम करने वाली कार्य पहचान नहीं है।

json
{
  "model": "seedance-2.5",
  "metadata": {
    "resolution": "1080p",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "EXISTING_SAMPLE_JOB_ID"}}
    ]
  }
}

सबमिशन और परिणाम

उत्तर के data में jobId, status, model और message हैं। सफल सबमिशन का अर्थ जॉब स्वीकार हुआ, पूरा नहीं। उसी खाते की API कुंजी से GET https://api.apihop.ai/v1/jobs/{jobId} पोल करें। असिंक्रोनस जॉब प्राप्त करें देखें।

स्थिति COMPLETED हो तो data.outputResult पढ़ें। हर परिणाम ऑब्जेक्ट के url में स्ट्रिंग और ऐरे दोनों मान स्वीकार करें।