Seedance API'si: İstemler ve komut dosyaları tek bir uç nokta üzerinden

Önkoşullar: SDK'yı Yükleyin

İlk isteginizi göndermeden önce, tercih ettiğiniz dil için resmi OpenAI SDK'sının yüklü olduğundan emin olun. Bu API, standart chat/completions protokolünü kullandığından, herhangi bir OpenAI uyumlu istemcisi çalışır. Python için paketi pip ile yükleyin. Node.js için npm kullanın. Temel metin üretimi veya fonksiyon çağırma için ek bağımlılıklara gerek yoktur; yalnızca istemci kütüphanesine ihtiyacınız vardır.

Kimlik Doğrulama: API Anahtarınızı Ayarlama

Kimlik doğrulama basit bir Bearer token aracılığıyla yapılır. Benzersiz anahtarınızı almak için API anahtarı al sayfasında bir hesap oluşturun. Deneme için kredi kartı gerekmez. Bu anahtarı bir ortam değişkeninde veya uygulamanızın yapılandırma dosyasında saklayın. Anahtar, sansürsüz modele erişim sağlar ve ön ödemeli kredi bakiyenize bağlıdır. İhtiyaç duyulması durumunda anahtarı panelinizden istediğiniz zaman yenileyin.

Bir Sohbet Tamamlama İsteği Gönderme

Temel URL'ye bir POST isteği gönderin. model alanını uncensored olarak ayarlayın. Rolü tanımlamak için sistem isteminizi ve içerik üretimi için kullanıcı mesajlarını ekleyin. Bu uç nokta, senaryo yazımı, altyazı oluşturma ve metin son işleme görevlerini verimli bir şekilde yönetir.

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."}]
  }'

Gerçek Zamanlı Çıktı için Akış Yanıtları

Uzun senaryolar veya gerçek zamanlı altyazı oluşturma için stream: true ayarlayarak akış özelliğini etkinleştirin. API, kısmi tamamlamaların Sunucu Tarafından Gönderilen Olaylar (SSE) akışını döndürür. Bu, uygulamanızın metni oluşturulurken görüntülemesini sağlar ve algılanan gecikmeyi iyileştirir. Arayüzü kademeli olarak güncellemek için akış parçalarını SDK'nızda işleyin.

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)

Yapılandırılmış Veriler için Fonksiyon Çağırma Kullanma

API, metinden yapılandırılmış verileri çıkarmak veya JSON çıktısı oluşturmak için fonksiyon çağırma desteği sunar. Araç şemalarınızı istekte tanımlayın. Model, kodunuzun çalıştırabileceği yapılandırılmış argümanlarla yanıt verecektir. Bu, oluşturulan komut dosyalarından veya meta verilerden belirli alanlara ihtiyacınız olduğunda son işleme adımları için idealdir.

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)

Limitler ve Kontenjanları Anlama

Standart HTTP durum kodlarına dikkat edin. Bir 401 hatası API anahtarınızın geçersiz veya süresi dolmuş olduğunu gösterir. Bir 402 hatası yetersiz ön ödemeli kredi olduğunu belirtir; devam etmek için bakiye yükleyin. Bir 429 hatası hız limitine ulaşıldığını gösterir; anahtar başına dakikada 300 istekle sınırlıdır. Bağlam penceresi toplam 100.000 token'dır. 8 MB'ı aşan istekler reddedilir.

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);