Seedance 1.0 Pro API: professionelt endpoint til videogenerering

Hvis du bygger video ind i et produkt, en arbejdsgang eller en pipeline, bliver web-UI'en før eller siden en flaskehals. Seedance 1.0 Pro API'en er den samme model som driver UI'en, eksponeret som et rent REST-endpoint med bearer-token-godkendelse, forudsigelig prisafregning per sekund og ligetil job-polling. Denne guide dækker alt, hvad du behøver for at sende det i produktion.

Hvad API'en giver dig

Alt, hvad Seedance 1.0 Pro web-UI'en tilbyder, tilgængeligt programmatisk:

• Billede-til-video-generering med en kildeimage-URL
• Bevægelsesprompter til at styre animationen
• Varighedsstyring fra 2 til 12 sekunder
• Slutbillede-styring til målrettede overgange
• Kameralås til/fra
• Job-polling for status og resultat-URL
• MP4-output i native 1080p

Brug det til SaaS-produkter, der har brug for integreret videogenerering, interne bureupipelines, batch-produktionsworkflows eller automatisering af gentagne videoopgaver.

Godkendelse

Alle API-kald godkendes med et bearer-token. Opret et fra dit Arteza-kontodashboard på arteza.ai.

Authorization: Bearer YOUR_API_KEY

Sikkerhedsregler:

• Gem aldrig API-nøgler i kildekontrol
• Roter nøgler regelmæssigt
• Brug miljøvariabler eller en secrets manager
• Begræns nøgler til specifikke kilder, hvis det er muligt

De centrale endpoints

Indsend et genereringsjob

POST /v1/seedance-1-pro/generate

Request body:

{
  "source_image_url": "https://your-cdn.com/source.jpg",
  "prompt": "Slow camera push-in on the subject, warm golden hour light, shallow depth of field",
  "duration_seconds": 6,
  "camera_lock": false,
  "end_frame_url": null
}

Parametre:

Svar:

{
  "job_id": "job_abc123xyz",
  "status": "queued",
  "created_at": "2026-04-10T12:00:00Z",
  "estimated_seconds": 90
}

Tjek jobstatus

GET /v1/seedance-1-pro/status/{job_id}

Svar (under behandling):

{
  "job_id": "job_abc123xyz",
  "status": "processing",
  "progress": 0.45,
  "created_at": "2026-04-10T12:00:00Z"
}

Svar (fuldført):

{
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "resolution": "1920x1080",
  "credits_charged": 144
}

Mulige statusværdier: queued, processing, completed, failed

Hent resultatet

Når status er completed, peger video_url på en 1080p MP4-fil. Hent den straks og gem den i din egen infrastruktur. Stol ikke på, at URL'en er gyldig på ubestemt tid.

Et komplet Python-eksempel

import os
import time
import requests

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1/seedance-1-pro"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def generate_video(source_image_url, prompt, duration=6, camera_lock=False, end_frame=None):
    payload = {
        "source_image_url": source_image_url,
        "prompt": prompt,
        "duration_seconds": duration,
        "camera_lock": camera_lock,
    }
    if end_frame:
        payload["end_frame_url"] = end_frame
    
    response = requests.post(f"{BASE_URL}/generate", headers=HEADERS, json=payload)
    response.raise_for_status()
    return response.json()["job_id"]

def wait_for_completion(job_id, poll_interval=5, timeout=300):
    start = time.time()
    while time.time() - start < timeout:
        r = requests.get(f"{BASE_URL}/status/{job_id}", headers=HEADERS)
        r.raise_for_status()
        data = r.json()
        
        if data["status"] == "completed":
            return data["video_url"]
        if data["status"] == "failed":
            raise RuntimeError(f"Job mislykkedes: {data.get('error', 'ukendt')}")
        
        time.sleep(poll_interval)
    
    raise TimeoutError(f"Job {job_id} blev ikke fuldført inden for {timeout}s")

def download_video(url, output_path):
    response = requests.get(url, stream=True)
    response.raise_for_status()
    with open(output_path, "wb") as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)

# Brug det
job_id = generate_video(
    source_image_url="https://example.com/product.jpg",
    prompt="Slow camera orbit around the product, studio lighting, 6 seconds",
    duration=6,
    camera_lock=True
)

video_url = wait_for_completion(job_id)
download_video(video_url, "output.mp4")
print(f"Video gemt som output.mp4")

Et komplet Node.js-eksempel

import fs from 'fs';
import fetch from 'node-fetch';

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1/seedance-1-pro';
const HEADERS = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
};

async function generateVideo(opts) {
  const response = await fetch(`${BASE_URL}/generate`, {
    method: 'POST',
    headers: HEADERS,
    body: JSON.stringify(opts)
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  const data = await response.json();
  return data.job_id;
}

async function waitForCompletion(jobId, { pollInterval = 5000, timeout = 300000 } = {}) {
  const start = Date.now();
  while (Date.now() - start < timeout) {
    const r = await fetch(`${BASE_URL}/status/${jobId}`, { headers: HEADERS });
    const data = await r.json();
    if (data.status === 'completed') return data.video_url;
    if (data.status === 'failed') throw new Error(`Job mislykkedes: ${data.error}`);
    await new Promise(res => setTimeout(res, pollInterval));
  }
  throw new Error('Timeout');
}

async function downloadVideo(url, path) {
  const response = await fetch(url);
  const buffer = await response.buffer();
  fs.writeFileSync(path, buffer);
}

// Brug det
const jobId = await generateVideo({
  source_image_url: 'https://example.com/product.jpg',
  prompt: 'Slow camera orbit around the product, studio lighting, 6 seconds',
  duration_seconds: 6,
  camera_lock: true
});

const videoUrl = await waitForCompletion(jobId);
await downloadVideo(videoUrl, 'output.mp4');
console.log('Gemt output.mp4');

Vil du have broadcast-kvalitet som denne? Prøv Seedance 1.0 Pro gratis →

Priser og afregning

Takst: ca. $0,12 per sekund outputvideo, rundet op til nærmeste hele credit

Credits trækkes kun ved vellykkede genereringer. Mislykkede job forbruger ingen credits.

Planerne er de samme som web-UI'en: $5 Starter, $25 Creator, $50 Pro, $120 Studio. Se prisside.

Hastighedsbegrænsninger og samtidighed

Standardkonti har hastighedsbegrænsninger, der passer til typiske integrationsbelastninger. For høj-volumen produktion bedes du kontakte support for hævede grænser.

Generel vejledning:

• 5-10 samtidige job er pålideligt for de fleste konti
• Eksponentielt backoff ved HTTP 429-svar
• Jobniveau-genforsøg ved forbigående fejl (op til 3 forsøg)
• Webhook-callbacks er tilgængelige for at undgå overdreven polling

Webhooks (valgfrit)

I stedet for polling kan du registrere en webhook-URL i dine kontoindstillinger eller per anmodning. Når et job er fuldført, sender Arteza en POST til din URL:

{
  "event": "job.completed",
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "credits_charged": 144,
  "timestamp": "2026-04-10T12:02:15Z"
}

Webhooks er signeret med en HMAC-signatur i X-Seedance-Signature-headeren. Verificer den, inden du stoler på payload'en.

Fejlhåndtering

API'en returnerer standard HTTP-statuskoder:

Fejlsvar indeholder et error-felt med en menneskelig fejlbesked og et code-felt til programmatisk håndtering.

{
  "error": "Kildeimage-URL'en kunne ikke hentes",
  "code": "source_image_unreachable"
}

Krav til inputbillede

• Formater: PNG, JPEG, WebP
• Størrelse: op til 10 MB per billede
• Opløsning: minimum 512x512, højere er bedre (1080p+ anbefales)
• URL-adgang: skal være offentligt tilgængelig fra Arteza-serverne (ingen localhost, ingen adgangsbeskyttede URL'er)

Til private billeder kan du uploade dem til en signeret S3-URL, CloudFront eller lignende og sende den signerede URL i anmodningen.

Bedste praksis

1. Gem output i din egen infrastruktur. Stol ikke på Arteza-URL'er på lang sigt.
2. Log alt. Job-ID'er, prompts, tidsstempler, statusovergange, fejl.
3. Prøv forbigående fejl igen. Netværksfejl og 5xx-svar bør forsøges igen med eksponentielt backoff.
4. Valider input tidligt. Tjek billede-URL'er og parameterområder, inden du indsender.
5. Overvåg credit-saldoen. Giv besked, når du falder under en grænse.
6. Brug webhooks i produktion. Polling er fint til små arbejdsbelastninger, men ineffektivt i stor skala.
7. Cache identiske genereringer. Hvis en bruger indsender det samme billede og den samme prompt to gange, returneres den cachede URL.

Test og staging

Start alle integrationer med $5 Starter-planen (60 credits om måneden). Det er nok til tyve 2-sekunders testgenereringer. Byg og test din integration fra ende til anden, inden du forpligter dig til en plan med højere volumen.

Anvendelsestilfælde

• SaaS-platforme - lad dine brugere generere video fra egne aktiver
• E-handel - generer produktbevægelsesvideo fra katalogbilleder
• Ejendomsmægling - automatiser produktionen af ejendomsvideoer fra fotos
• Marketingautomatisering - personaliseret video i stor skala
• Indholdsplatforme - berig artikler, opslag eller sociale indlæg med genereret video
• White-label-videoværktøjer - byg dit eget AI-videoprodukt på Arteza-backend'en

Relateret læsning

• Arbejdsgange til batchbehandling
• Komplet guide til Seedance 1.0 Pro
• Seedance 1.0 Pro til bureauer
• Seedance 2.0 API-guide

Ofte stillede spørgsmål

Kan jeg bruge API'en til kommercielle applikationer? Ja, alt output er klargjort til kommerciel brug.

Hvad sker der, hvis genereringen mislykkes? Der trækkes ingen credits ved mislykkede genereringer.

Hvor længe er genererede videoer hostet? Videoer er tilgængelige til download i en tidsperiode efter generering. Hent og gem dem straks.

Understøtter I SDK-biblioteker? Community-SDK'er til Python og Node er tilgængelige. Se udvikleroplysningerne på arteza.ai.

Kan jeg annullere et igangværende job? Ja, send DELETE /v1/seedance-1-pro/jobs/{job_id}. Der trækkes ingen credits for annullerede job.

Hvordan får jeg support? Send en e-mail til support via dit kontodashboard ved API-specifikke problemer.

---

Seedance 1.0 Pro API'en er den produktionsklare vej til at indlejre 1080p AI-videogenerering i dit produkt eller din pipeline.

Få din API-nøgle og begynd at bygge → med 10 gratis credits inkluderet ved tilmelding.