Seedance API：單一端點處理提示詞與腳本

先決條件：安裝 SDK

在發送第一個請求之前，請確保已安裝你偏愛語言的官方 OpenAI SDK。此 API 使用標準的 chat/completions 協定，因此任何與 OpenAI 相容的用戶端皆可運作。對於 Python，請透過 pip 安裝套件。對於 Node.js，請使用 npm。你只需要用戶端程式庫；基本文字產生或工具呼叫不需要額外的相依套件。

驗證：設定你的 API 金鑰

驗證透過簡單的 Bearer token 處理。在 取得 API 金鑰 頁面建立帳戶以取得你的唯一金鑰。試用不需要信用卡。將此金鑰儲存在環境變數或應用程式的設定檔中。該金鑰可存取無審查模型，並與你的預付額度餘額綁定。如有需要，可隨時從儀表板重新產生金鑰。

傳送聊天補全請求

對基礎 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 中處理串流區塊，以逐步更新使用者介面。

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 token。超過 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);