- Basis-URL
- https://api.seedanceapis.com/v1
- Model
- ongecensureerd
Seedance API: prompts en scripts via één endpoint
Kom in enkele minuten aan de slag met de Seedance API. Gebruik ons OpenAI-compatible endpoint om ongecensureerde scripts en bijschriften te genereren voor je creatieve pipeline.
Vereisten: SDK installeren
Voordat je je eerste verzoek verzendt, zorg er dan voor dat je de officiële OpenAI SDK voor je voorkeurstaal hebt geïnstalleerd. Deze API gebruikt het standaard chat/completions-protocol, dus elke OpenAI-compatibele client werkt. Voor Python installeer je het pakket via pip. Voor Node.js gebruik je npm. Je hebt alleen de clientbibliotheek nodig; voor basis tekstgeneratie of tool calling zijn geen extra afhankelijkheden vereist.
Authenticatie: je API-sleutel instellen
Authenticatie wordt afgehandeld via een eenvoudige Bearer-token. Maak een account aan op de API-sleutel ophalen-pagina om je unieke sleutel te ontvangen. Er is geen creditcard nodig voor de proefversie. Sla deze sleutel op in een omgevingsvariabele of het configuratiebestand van je applicatie. De sleutel geeft toegang tot het ongecensureerde model en is gekoppeld aan je saldo aan prepaid tegoed. Regenereren de sleutel op elk moment via je dashboard als dat nodig is.
Een chatvoltooiingsverzoek versturen
Maak een POST-verzoek naar de basis-URL. Het veld model moet worden ingesteld op uncensored. Voeg je systeem-prompt toe om de rol te definiëren, en gebruikersberichten voor de tekstgeneratie. Dit endpoint verwerkt efficiënt taken voor scriptwriting, bijschriften en tekstnabewerking.
curl 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."}]
}'
Streamingresponsen voor realtime uitvoer
Voor lange scripts of realtime bijschriften, schakel streaming in door stream: true in te stellen. De API retourneert een Server-Sent Events (SSE)-stream van gedeeltelijke voltooiingen. Hiermee kan je applicatie tekst weergeven terwijl deze wordt gegenereerd, wat de waargenomen latentie verbetert. Verwerk de streamchunks in je SDK om de UI incrementeel bij te werken.
stream = 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)
Tool calling gebruiken voor gestructureerde gegevens
De API ondersteunt function calling om gestructureerde gegevens uit tekst te extraheren of JSON-uitvoer te genereren. Definieer je toolschema's in het verzoek. Het model reageert met gestructureerde argumenten die je code kan uitvoeren. Dit is ideaal voor stappen in de nabewerking waarbij je specifieke velden uit gegenereerde scripts of metadata nodig hebt.
from 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)
Begrijpen van limieten en quota's
Houd standaard HTTP-statuscodes in de gaten. Een 401-fout betekent dat je API-sleutel ongeldig of verlopen is. Een 402-fout geeft aan dat er onvoldoende prepaid tegoed is; laad op om door te gaan. Een 429-fout geeft rate limiting aan, beperkt tot 300 verzoeken per minuut per sleutel. Het contextvenster is 100.000 tokens in totaal. Verzoeken groter dan 8 MB worden afgewezen.
import 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);Technische specificaties
Alle echte limieten en functies van de API op één plek — controleer ze voordat je opwaardeert.
| Onderdeel | Waarde |
|---|---|
| API-formaat | OpenAI-compatibel: elke OpenAI-SDK werkt — vervang alleen base URL en sleutel |
| Model-ID | uncensored |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Authenticatie | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.seedanceapis.com/v1 |
| Max. uitvoer | tot de rest van het venster van 100.000 tokens; max_tokens optioneel (geen aparte limiet) |
| Function calling | ja — tools, tool_choice; antwoorden bevatten tool_calls, ook bij streaming; resultaten als role: tool |
| Streaming | ja — server-sent events; het laatste deel bevat het tokenverbruik |
| Parameters | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON-modus | response_format: {"type": "json_object"} |
| Contextvenster | 100.000 tokens (invoer + uitvoer) |
| Rate limit | 300 verzoeken per minuut per sleutel |
| Gelijktijdige verzoeken | tot 8 tegelijk per sleutel |
| Responsheaders | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Verzoekgrootte | tot 8 MB |
| Prijs | $0,25 per 1 mln invoertokens · $1,00 per 1 mln uitvoertokens |
| Gratis proeftegoed | $0,50 voor 7 dagen, zonder kaart · Proefsleutel: 2 parallelle verzoeken, 60 per minuut; volledige limieten (8 en 300) na eerste opwaardering |
| Geldigheid | betaald tegoed verloopt niet, geen abonnement |
| Afrekening | prepaid tegoed op basis van echt verbruik; fouten en weigeringen zijn gratis |
| Bonus | +5% vanaf $50, +10% vanaf $100 |
| Opwaarderen | USDT (TRC20) of USDC (Base), elk heel bedrag van $10 tot $500 |
| Inloggen | Google of e-mail en wachtwoord |
| Sleutels | één actieve sleutel per account; een nieuwe vervangt de oude |
| Inhoud | inhoud voor volwassenen toegestaan; seksuele inhoud met minderjarigen wordt geweigerd |
Foutcodes
Fouten komen als JSON met een vaste type; mislukte of geweigerde verzoeken kosten niets.
| Code | Type | Betekenis |
|---|---|---|
400 | bad_request | ongeldige JSON, lege berichten, verkeerde parameter of context te lang |
401 | missing_key · invalid_key · key_revoked | sleutel ontbreekt, is onjuist of is vervangen |
402 | no_credit | geen tegoed — waardeer op en ga direct verder |
403 | content_blocked | seksuele inhoud met minderjarigen — geweigerd, niet gerekend |
404 | not_found | onbekend endpoint |
413 | request_too_large | body groter dan 8 MB |
429 | rate_limited · concurrency | meer dan 300/min of 8 tegelijk — wacht en probeer opnieuw |
503 | upstream_busy | model bezet — probeer het over enkele seconden opnieuw |
Vragen en antwoorden
Genereert de Seedance API afbeeldingen of video?
Nee. Dit is een API voor tekstvoltooiing. Het biedt de ongecensureerde LLM-laag voor scripts, bijschriften en nabewerking. Gebruik aparte tools voor het genereren van afbeeldingen of video.
Wat is het contextvenster van het ongecensureerde model?
Het model ondersteunt een contextvenster van 100.000 tokens, inclusief zowel de input-prompt als de gegenereerde uitvoer. Dit stelt je in staat uitgebreide scripts of documentanalyse in één verzoek te verwerken.
Hoe controleer ik mijn tegoed?
Je kunt je resterende prepaid tegoed bekijken in je accountdashboard. Als je een 402-fout krijgt, is je saldo te laag voor het verzoek. Opwaarderingen beginnen vanaf $10.
Je sleutel is nog maar één formulier verwijderd
Maak een account aan, kopieer de sleutel, pas de basis-URL aan. Dat is de hele setup.