API Seedance: Prompt dan skrip melalui satu endpoint

Prasyarat: Instal SDK

Sebelum mengirim permintaan pertama Anda, pastikan Anda telah menginstal SDK resmi OpenAI untuk bahasa pilihan Anda. API ini menggunakan protokol chat/completions standar, sehingga klien yang kompatibel dengan OpenAI dapat digunakan. Untuk Python, instal paket melalui pip. Untuk Node.js, gunakan npm. Anda hanya memerlukan pustaka klien; tidak ada dependensi tambahan yang diperlukan untuk generasi teks dasar atau pemanggilan alat.

Autentikasi: Mengatur Kunci API Anda

Autentikasi ditangani melalui token Bearer sederhana. Buat akun di halaman Dapatkan kunci API untuk menerima kunci unik Anda. Tidak diperlukan kartu kredit untuk uji coba. Simpan kunci ini dalam variabel lingkungan atau file konfigurasi aplikasi Anda. Kunci ini memberikan akses ke model tanpa sensor dan terkait dengan saldo saldo prabayar Anda. Regenerasi kunci kapan saja dari dasbor Anda jika diperlukan.

Mengirim Permintaan Penyelesaian Chat

Buat permintaan POST ke URL dasar. Bidang model harus diatur ke uncensored. Sertakan prompt sistem Anda untuk menentukan peran, dan pesan pengguna untuk pembuatan konten. Endpoint ini menangani tugas penulisan naskah, pembuatan keterangan, dan pemrosesan teks akhir secara efisien.

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

Respons Streaming untuk Output Waktu Nyata

Untuk skrip panjang atau caption waktu nyata, aktifkan streaming dengan mengatur stream: true. API mengembalikan aliran Event yang Dikirim Server (SSE) dari kelengkapan parsial. Ini memungkinkan aplikasi Anda menampilkan teks saat dihasilkan, meningkatkan latensi yang dirasakan. Tangani potongan aliran di SDK Anda untuk memperbarui UI secara bertahap.

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)

Menggunakan Pemanggilan Alat untuk Data Terstruktur

API mendukung pemanggilan fungsi untuk mengekstrak data terstruktur dari teks atau menghasilkan output JSON. Tentukan skema alat Anda dalam permintaan. Model akan merespons dengan argumen terstruktur yang dapat dieksekusi oleh kode Anda. Ini sangat ideal untuk langkah-langkah pasca-pemrosesan di mana Anda memerlukan bidang tertentu dari skrip yang dihasilkan atau metadata.

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)

Memahami Batas dan Kuota

Perhatikan kode status HTTP standar. Kesalahan 401 berarti kunci API Anda tidak valid atau kedaluwarsa. Kesalahan 402 menunjukkan saldo prabayar tidak cukup; isi ulang untuk melanjutkan. Kesalahan 429 menandakan pembatasan laju, dibatasi pada 300 permintaan per menit per kunci. Jendela konteks adalah 100.000 token total. Permintaan yang melebihi 8 MB akan ditolak.

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