Seedream v4.5 API: Integrieren Sie KI-Bilder in Ihre App

Die Integration von KI-Bildgenerierung in Ihre App bedeutete früher, sich zwischen drei schlechten Optionen zu entscheiden: Stable Diffusion selbst betreiben (teure Infrastruktur), OpenAI nach Token-Rate bezahlen (unvorhersehbare Kosten) oder sich auf eine Abonnement-API festlegen (verschwendete Kapazität). Die Seedream v4.5 API funktioniert anders - zahlen Sie pro Bild für $0.08, Standard-REST und Antwortzeiten gemessen in Sekunden. Dieser Leitfaden bringt Sie in unter 10 Minuten von null zur ersten Generierung.

Zusammenfassung

• Seedream v4.5 API kostet 8 Credits (~$0.08) pro generiertem Bild
• Standard-REST-API mit JSON-Anfragen und -Antworten
• Parameter: Prompt, Auflösung, Seitenverhältnis, num_images (1-6), Guidance-Skala
• Typische Antwortzeit: 5-15 Sekunden pro Generierung
• Kein Abonnement-Minimum - bezahlen Sie nur für das, was Sie generieren

Wofür die API geeignet ist

Die Seedream v4.5 API passt zu Anwendungen, die On-Demand-KI-Bildgenerierung mit vorhersehbaren Pro-Bild-Kosten benötigen. Häufige Anwendungsfälle:

SaaS-Produkte, mit denen Benutzer Bilder als Teil ihres Workflows generieren können - Design-Tools, Marketing-Plattformen, Content-Creation-Apps.

E-Commerce-Plattformen, die programmgesteuert Produktlebensstil-Bilder oder Kategorieheader generieren.

Marketing-Automatisierungstools, die Kampagnenvisuals basierend auf strukturierten Eingaben erstellen.

Content-Management-Systeme, die KI-Bildgenerierung als natives Feature anbieten.

Entwicklerprojekte und Automatisierungsskripte für jeden Workflow, der Bildgenerierung im großen Maßstab benötigt.

Mobile Apps, die die API von einem Backend-Service aufrufen, um die Bildgenerierung off-device zu halten.

Wenn Ihr Anwendungsfall einem dieser entspricht, hilft Ihnen dieser Leitfaden bei der schnellen Integration.

Authentifizierung und erste Schritte

Schritt 1: API-Schlüssel abrufen

Registrieren für ein Arteza-Konto, falls Sie noch keines haben. Navigieren Sie zu Ihren Kontoeinstellungen und generieren Sie einen API-Schlüssel. Behandeln Sie diesen Schlüssel wie ein Passwort - committen Sie ihn nicht in öffentliche Repositories.

Schritt 2: Credits zu Ihrem Konto hinzufügen

Die API-Nutzung wird von demselben Credit-Guthaben wie die Web-Nutzung abgezogen. Ihre 50 kostenlosen Anmeldungs-Credits funktionieren bei API-Aufrufen. Für die Produktionsnutzung abonnieren Sie von Preisseite ab $10.

Schritt 3: Machen Sie Ihre erste Anfrage

Der API-Endpunkt für Seedream v4.5 ist:

POST https://api.arteza.ai/v1/images/generate

Minimaler Request Body:

{
  "model": "seedream-v4-5",
  "prompt": "A cozy bookstore at dusk, warm window light",
  "width": 2048,
  "height": 2048,
  "num_images": 1
}

Fügen Sie Ihren API-Schlüssel in den Authorization-Header ein:

Authorization: Bearer YOUR_API_KEY

Vollständige Parameterreferenz

Unterstützte Auflösungen

Seedream v4.5 unterstützt mehrere Auflösungsoptionen bis zu 4 Megapixel:

Code-Beispiele

Node.js (Fetch)

const generateImage = async (prompt) => {
  const response = await fetch(
    'https://api.arteza.ai/v1/images/generate',
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.SEEDANCE_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        model: 'seedream-v4-5',
        prompt: prompt,
        width: 2048,
        height: 2048,
        num_images: 1,
      }),
    }
  );

  if (!response.ok) {
    throw new Error(`API error: ${response.status}`);
  }

  const data = await response.json();
  return data.images[0].url;
};

// Verwendung
const imageUrl = await generateImage(
  'A cozy bookstore at dusk, warm window light, editorial photography'
);
console.log(imageUrl);

Python (Requests)

import os
import requests

def generate_image(prompt, width=2048, height=2048, num_images=1):
    response = requests.post(
        'https://api.arteza.ai/v1/images/generate',
        headers={
            'Authorization': f'Bearer {os.environ["SEEDANCE_API_KEY"]}',
            'Content-Type': 'application/json',
        },
        json={
            'model': 'seedream-v4-5',
            'prompt': prompt,
            'width': width,
            'height': height,
            'num_images': num_images,
        },
    )
    response.raise_for_status()
    data = response.json()
    return [img['url'] for img in data['images']]

# Verwendung
urls = generate_image(
    'An editorial product photograph of a ceramic coffee mug, '
    'warm morning light, minimalist composition'
)
print(urls)

cURL

curl -X POST https://api.arteza.ai/v1/images/generate \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v4-5",
    "prompt": "A futuristic city skyline at sunset, cinematic photography",
    "width": 2048,
    "height": 1152,
    "num_images": 1
  }'

Go

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

type GenerateRequest struct {
    Model     string `json:"model"`
    Prompt    string `json:"prompt"`
    Width     int    `json:"width"`
    Height    int    `json:"height"`
    NumImages int    `json:"num_images"`
}

func generateImage(prompt string) (string, error) {
    reqBody := GenerateRequest{
        Model:     "seedream-v4-5",
        Prompt:    prompt,
        Width:     2048,
        Height:    2048,
        NumImages: 1,
    }

    jsonData, _ := json.Marshal(reqBody)
    req, _ := http.NewRequest(
        "POST",
        "https://api.arteza.ai/v1/images/generate",
        bytes.NewBuffer(jsonData),
    )
    req.Header.Set("Authorization", "Bearer "+os.Getenv("SEEDANCE_API_KEY"))
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        return "", err
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    images := result["images"].([]interface{})
    firstImage := images[0].(map[string]interface{})
    return firstImage["url"].(string), nil
}

Antwortformat

Erfolgreiche Antworten geben JSON mit dieser Struktur zurück:

{
  "id": "gen_abc123xyz",
  "model": "seedream-v4-5",
  "created": 1712764800,
  "images": [
    {
      "url": "https://cdn.arteza.ai/gen/abc123.png",
      "width": 2048,
      "height": 2048,
      "seed": 42871
    }
  ],
  "credits_used": 8,
  "credits_remaining": 1042
}

Bild-URLs sind 24 Stunden lang gültig. Laden Sie Bilder sofort herunter und speichern Sie sie, wenn Sie permanenten Zugriff benötigen.

Wollen Sie solche Details? Seedream v4.5 kostenlos ausprobieren →

Bereit mit der Integration zu beginnen? Erhalten Sie Ihren API-Schlüssel →

Fehlerbehandlung

Die API gibt Standard-HTTP-Statuscodes zurück:

Beispiel-Fehlerantwort:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Your account has insufficient credits for this request",
    "credits_required": 8,
    "credits_available": 3
  }
}

Implementieren Sie immer Fehlerbehandlung und Wiederholungen für 429- und 500-Fehler. Nicht wiederholen Sie 400- und 401-Fehler - diese erfordern eine Behebung der Anfrage selbst.

Best Practices für die Produktionsnutzung

Rate Limiting

Standard-Rate-Limits ermöglichen einen angemessenen Produktionsdurchsatz. Wenn Sie höhere Limits benötigen, kontaktieren Sie den Support mit Details zu Ihrem Anwendungsfall.

Implementieren Sie exponentielles Backoff bei 429-Fehlern:

import time

def generate_with_retry(prompt, max_retries=3):
    for attempt in range(max_retries):
        try:
            return generate_image(prompt)
        except requests.HTTPError as e:
            if e.response.status_code == 429:
                wait_time = 2 ** attempt
                time.sleep(wait_time)
                continue
            raise
    raise Exception("Max retries exceeded")

Credit-Management

Überwachen Sie das Feld credits_remaining in jeder Antwort. Richten Sie Warnungen ein, wenn das Guthaben unter einen Schwellenwert fällt, damit Sie vor dem Produktionsverkehr auf Null Credits aufstocken können.

def check_credits(response):
    remaining = response.json().get('credits_remaining', 0)
    if remaining < 100:
        send_alert(f'Low credit warning: {remaining} credits')

Asynchrone Verarbeitung

Für benutzergerichtete Anwendungen behandeln Sie die Bildgenerierung als asynchron. Blockieren Sie nicht den UI-Thread bei einem 5-15-Sekunden-API-Aufruf. Muster:

• Geben Sie sofort eine Job-ID zurück, fragen Sie nach Abschluss ab
• Verwenden Sie Webhooks (falls unterstützt) für Abschlussbenachrichtigungen
• Generieren Sie spekulativ im Hintergrund und cachen Sie Ergebnisse

Caching

Generierte Bilder sind deterministisch mit demselben Prompt und Seed. Cachen Sie aggressiv nach Prompt-Hash, um zu vermeiden, dass identische Bilder regeneriert werden.

import hashlib

def prompt_cache_key(prompt, width, height, seed):
    raw = f'{prompt}|{width}x{height}|{seed}'
    return hashlib.sha256(raw.encode()).hexdigest()

Prompt-Sicherheit

Wenn Ihre App Prompts für Endbenutzer verfügbar macht, implementieren Sie Content-Filterung vor dem Senden an die API. Arteza hat Content-Richtlinien - Prompts, die dagegen verstoßen, geben Fehler zurück, verschwenden Credits und führen zu benutzergerichteten Fehlern.

Preise für die API-Nutzung

Die API-Nutzung wird von Ihrem Konto-Credit-Guthaben mit derselben Rate wie die Web-Nutzung abgezogen.

Credits kommen vom selben Preisstufen unabhängig davon, ob Sie sie über Web oder API verwenden:

• Starter: $10 = 1.050 Credits = ~131 Bilder
• Popular: $25 = 2.750 Credits = ~343 Bilder
• Creator: $50 = 5.750 Credits = ~718 Bilder
• Studio: $100 = 12.000 Credits = ~1.500 Bilder

Kunden mit höherem Volumen können den Support zu Volume-Preisen für kontinuierliche Nutzung über 100.000 Bilder/Monat kontaktieren.

Kombination mit anderen Arteza-Modellen

Ihre Anwendung kann mehrere Seedance-Modelle über dieselbe API verwenden, indem Sie den model-Parameter ändern:

• seedream-v4-5 - 8 Credits - Flagship-Qualität
• seedream-v3 - 6 Credits - schneller, einfacher
• seedream-5-lite - 7 Credits - Deep-Thinking-Modus
• seedream-5-edit - 7 Credits - Bildbearbeitung
• seedance-2 - Videogenerierung (anderer Endpunkt)

Für Anwendungen, die zusätzlich zur Generierung Bearbeitungsfunktionen benötigen, übernimmt seedream-5-edit textbasierte Bildbearbeitung. Weitere Details finden Sie in Seedream 5 Edit-Dokumentation.

Sicherheitsüberlegungen

Setzen Sie API-Schlüssel niemals client-seitig frei. Leiten Sie API-Aufrufe immer über Ihr Backend. Offengelegte Schlüssel können verwendet werden, um Ihr Credit-Guthaben zu entleeren.

Drehen Sie Schlüssel regelmäßig. Wenn ein Schlüssel kompromittiert wird, widerrufen Sie ihn und generieren Sie einen neuen.

Protokollieren Sie Anfragen zum Debuggen. Fügen Sie Request-IDs in Ihre Logs ein, damit Sie Fehler mit API-Antworten korrelieren können.

Implementieren Sie Nutzungsquoten pro Benutzer. Wenn Ihre App KI-Generierung als Feature anbietet, begrenzen Sie den Pro-Benutzer-Verbrauch, um Missbrauch zu verhindern.

Häufig gestellte Fragen

Gibt es einen kostenlosen Tier für die API? Ihre 50 Signup-Credits funktionieren bei API-Aufrufen. Das sind 6 kostenlose Seedream v4.5-Generierungen zum Testen der Integration vor der Bezahlung.

Wie lange dauert die typische Antwortzeit? 5-15 Sekunden für Seedream v4.5 je nach Auflösung und aktuelle Last.

Kann ich die API für kommerzielle Produkte verwenden? Ja. Die kommerzielle Nutzung ist enthalten. Generierte Bilder Ihrer Kunden gehören ihnen zur Verwendung für jeden legitimen Zweck.

Gibt es ein Python SDK? Offizielle SDKs sind in Entwicklung. Die aktuelle REST-API funktioniert sauber mit Standard-HTTP-Bibliotheken in jeder Sprache.

Wie handhabe ich Content-Policy-Fehler? Implementieren Sie benutzergerichtete Meldungen, die erklären, dass der Prompt abgelehnt wurde. Protokollieren Sie den spezifischen Fehler zum Debuggen.

Was passiert, wenn mir während einer Anfrage die Credits ausgehen? Die API gibt einen 402-Fehler zurück, bevor die Generierung beginnt. Teilzahlungen treten nie auf - Sie erhalten entweder das vollständige Bild oder einen Fehler.

Kann ich mehrere Prompts in einer Anfrage bündeln? Nicht direkt. Verwenden Sie num_images: 6, um Variationen desselben Prompts zu erhalten, oder führen Sie parallele API-Aufrufe für verschiedene Prompts durch.

---

Die Seedream v4.5 API gibt Ihnen produktionsreife KI-Bildgenerierung mit vorhersehbaren Pro-Bild-Preisen und Standard-REST-Konventionen. Bei den meisten Integrationen können Sie in unter 10 Minuten von API-Schlüssel zur ersten funktionierenden Generierung gelangen. Für Fragen oder Volume-Preise wenden Sie sich über Ihr Konto-Dashboard an den Support.

Starten Sie heute mit der Integration. Erhalten Sie Ihren API-Schlüssel → | Vollständige Preisübersicht anzeigen → | Lesen Sie das v4.5-Handbuch →