API Seedance: prompt e script su un unico endpoint

Prerequisiti: installa l'SDK

Prima di inviare la tua prima richiesta, assicurati di aver installato l'SDK ufficiale OpenAI per il tuo linguaggio preferito. Questa API utilizza il protocollo standard chat/completions, quindi qualsiasi client compatibile con OpenAI funziona. Per Python, installa il pacchetto tramite pip. Per Node.js, usa npm. Ti serve solo la libreria client; non sono richieste dipendenze aggiuntive per la generazione di testo di base o la chiamata di funzioni.

Autenticazione: imposta la tua chiave API

L'autenticazione avviene tramite un semplice token Bearer. Crea un account nella pagina Ottieni chiave API per ricevere la tua chiave univoca. Non è richiesta una carta di credito per la prova. Memorizza questa chiave in una variabile d'ambiente o nel file di configurazione della tua applicazione. La chiave concede l'accesso al modello senza censura ed è legata al tuo saldo di credito prepagato. Rigenera la chiave in qualsiasi momento dalla dashboard se necessario.

Invio di una richiesta di completamento chat

Esegui una richiesta POST all'URL di base. Il campo model deve essere impostato su uncensored. Includi il tuo prompt di sistema per definire il ruolo e i messaggi dell'utente per la generazione del contenuto. Questo endpoint gestisce in modo efficiente la sceneggiatura, la creazione di didascalie e le attività di post-produzione del testo.

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

Risposte in streaming per output in tempo reale

Per script lunghi o didascalie in tempo reale, abilita lo streaming impostando stream: true. L'API restituisce uno stream di eventi inviati dal server (SSE) di completamenti parziali. Questo permette alla tua applicazione di visualizzare il testo man mano che viene generato, migliorando la latenza percepita. Gestisci i chunk dello stream nel tuo SDK per aggiornare l'interfaccia utente in modo incrementale.

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)

Utilizzo della chiamata di funzioni per dati strutturati

L'API supporta la chiamata di funzioni per estrarre dati strutturati dal testo o generare output JSON. Definisci gli schemi dei tuoi strumenti nella richiesta. Il modello risponderà con argomenti strutturati che il tuo codice può eseguire. Questo è ideale per i passaggi di post-produzione in cui hai bisogno di campi specifici dagli script generati o dai metadati.

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)

Comprensione dei limiti e delle quote

Tieni d'occhio i codici di stato HTTP standard. Un errore 401 indica che la tua chiave API non è valida o è scaduta. Un errore 402 indica credito prepagato insufficiente; ricarica per continuare. Un errore 429 segnala il superamento del limite di richieste, limitato a 300 richieste al minuto per chiave. La finestra di contesto è di 100.000 token in totale. Le richieste superiori a 8 MB verranno rifiutate.

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