Seedance API: एक एंडपॉइंट के माध्यम से प्रॉम्प्ट और स्क्रिप्ट

पूर्वशर्त: SDK इंस्टॉल करें

अपना पहला अनुरोध भेजने से पहले, सुनिश्चित करें कि आपके पसंदीदा भाषा के लिए आधिकारिक OpenAI SDK इंस्टॉल है। यह API मानक chat/completions प्रोटोकॉल का उपयोग करती है, इसलिए कोई भी OpenAI-कम्पैटिबल क्लाइंट काम करता है। Python के लिए, pip के माध्यम से पैकेज इंस्टॉल करें। Node.js के लिए, npm का उपयोग करें। आपको केवल क्लाइंट लाइब्रेरी की आवश्यकता है; बेसिक टेक्स्ट जनरेशन या टूल कॉलिंग के लिए कोई अतिरिक्त डिपेंडेंसी की आवश्यकता नहीं है।

प्रमाणीकरण: अपनी API कुंजी सेट करना

प्रमाणीकरण एक सरल Bearer टोकन के माध्यम से किया जाता है। अपनी अद्वितीय कुंजी प्राप्त करने के लिए Get API key पृष्ठ पर एक खाता बनाएं। ट्रायल के लिए किसी क्रेडिट कार्ड की आवश्यकता नहीं है। इस कुंजी को एक पर्यावरण चर या अपने एप्लिकेशन के कॉन्फ़िगरेशन फ़ाइल में संग्रहीत करें। यह कुंजी बिना सेंसर मॉडल तक पहुंच प्रदान करती है और आपके प्रीपेड क्रेडिट शेष से जुड़ी होती है। यदि आवश्यक हो तो किसी भी समय अपने डैशबोर्ड से कुंजी को पुनः उत्पन्न करें।

चैट कम्प्लीशन अनुरोध भेजना

बेस URL पर एक POST अनुरोध बनाएं। model फ़ील्ड को uncensored पर सेट किया जाना चाहिए। भूमिका परिभाषित करने के लिए अपना सिस्टम प्रॉम्प्ट शामिल करें, और कंटेंट जनरेशन के लिए यूजर मेसेज। यह एंडपॉइंट स्क्रिप्टलेखन, कैप्शनिंग और पोस्ट-प्रोसेसिंग टेक्स्ट टास्क को कुशलता से संभालता है।

Copycurl https://api.seedanceapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

रियल-टाइम आउटपुट के लिए स्ट्रीमिंग रिस्पॉन्स

लंबे स्क्रिप्ट या रियल-टाइम कैप्शनिंग के लिए, stream: true सेट करके स्ट्रीमिंग सक्षम करें। API आंशिक पूर्णता का एक Server-Sent Events (SSE) स्ट्रीम लौटाता है। इससे आपका एप्लिकेशन उत्पन्न होते समय टेक्स्ट प्रदर्शित कर सकता है, जिससे विलंबता में सुधार होता है। SDK में स्ट्रीम चंक को संभालें ताकि UI को क्रमिक रूप से अपडेट किया जा सके।

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

स्ट्रक्चर्ड डेटा के लिए टूल कॉलिंग का उपयोग

API टेक्स्ट से स्ट्रक्चर्ड डेटा निकालने या JSON आउटपुट जनरेट करने के लिए फ़ंक्शन कॉलिंग का समर्थन करता है। अनुरोध में अपनी टूल स्कीमा परिभाषित करें। मॉडल स्ट्रक्चर्ड आर्गुमेंट्स के साथ जवाब देगा जिन्हें आपका कोड एक्जीक्यूट कर सकता है। यह उन पोस्ट-प्रोसेसिंग स्टेप्स के लिए आदर्श है जहां आपको जनरेट की गई स्क्रिप्ट या मेटाडेटा से विशिष्ट फ़ील्ड्स की आवश्यकता होती है।

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.seedanceapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

लिमिट और क्वोटा को समझना

मानक HTTP स्टेटस कोड के लिए सावधान रहें। एक 401 त्रुटि का अर्थ है कि आपकी API कुंजी अमान्य या समाप्त हो गई है। एक 402 त्रुटि अपर्याप्त प्रीपेड क्रेडिट को इंगित करती है; जारी रखने के लिए टॉप-अप करें। एक 429 त्रुटि रेट लिमिटिंग को संकेत देती है, जो प्रति कुंजी प्रति मिनट 300 अनुरोध तक सीमित है। कॉन्टेक्स्ट विंडो कुल 100,000 टोकन है। 8 MB से अधिक अनुरोध अस्वीकार कर दिए जाएंगे।

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.seedanceapis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);