Seedream v4.5 API: Integreer AI-afbeeldingen in uw app

AI-afbeeldingsgeneratie integreren in uw app betekende vroeger kiezen tussen drie slechte opties: Stable Diffusion zelf uitvoeren (dure infrastructuur), betalen volgens de OpenAI per-token tarieven (onvoorspelbare kosten), of zich inschrijven voor een abonnements-API (verspilde capaciteit). De Seedream v4.5 API is anders gebouwd - betaal per afbeelding voor $0.08, standaard REST en reactietijden gemeten in seconden. Deze handleiding brengt u van nul tot eerste generatie in onder de 10 minuten.

Waar de API goed voor is

De Seedream v4.5 API is geschikt voor toepassingen die on-demand AI-afbeeldingsgeneratie met voorspelbare kosten per afbeelding nodig hebben. Veelgestelde use cases:

SaaS-producten waarmee gebruikers afbeeldingen kunnen genereren als onderdeel van hun werkstroom - design tools, marketingplatforms, content creatie-apps.

E-commerce-platforms die productbeelden of categoriebanden programmatisch genereren.

Marketingautomatiseringstools die campagnevisuals op basis van gestructureerde invoer produceren.

Content management systems die AI-afbeeldingsgeneratie als native functie aanbieden.

Ontwikkelaarsprojecten en automatiseringsscripts voor elk werkstroom dat afbeeldingsgeneratie op schaal nodig heeft.

Mobiele apps die de API vanuit een backendservice aanroepen om de afbeeldingsgeneratie off-device te houden.

Als uw use case overeenkomt met een van deze opties, krijgt u met deze handleiding snel integratie.

Authenticatie en aan de slag

Stap 1: Een API-sleutel ophalen

Registreren voor een Arteza-account als u er nog geen hebt. Navigeer naar uw accountinstellingen en genereer een API-sleutel. Behandel deze sleutel als een wachtwoord - commit deze niet naar openbare repositories.

Stap 2: Credits aan uw account toevoegen

API-gebruik trekt van dezelfde tegoedsaldo als webgebruik. Uw 50 gratis aanmeldingscredits werken op API-aanroepen. Voor productiegebruik abonneert u via de pagina met prijzen vanaf $10.

Stap 3: Uw eerste verzoek indienen

Het API-eindpunt voor Seedream v4.5 is:

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

Minimale verzoekstructuur:

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

Neem uw API-sleutel op in de autorisatieheader:

Authorization: Bearer YOUR_API_KEY

Volledige parameterverwijzing

Ondersteunde resoluties

Seedream v4.5 ondersteunt meerdere resolutie-opties tot 4 megapixels:

Code voorbeelden

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

// Usage
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']]

# Usage
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
}

Antwoordformaat

Succesvolle antwoorden retourneren JSON met deze structuur:

{
  "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
}

Afbeeldings-URL's zijn 24 uur geldig. Download en sla afbeeldingen onmiddellijk op als u permanente toegang nodig hebt.

Wil je dit soort detail? Probeer Seedream v4.5 gratis →

Klaar om te gaan integreren? Krijg je API-sleutel →

Foutafhandeling

De API retourneert standaard HTTP-statuscodes:

Voorbeeld foutantwoord:

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

Implementeer altijd foutafhandeling en opnieuw proberen voor 429 en 500 fouten. Probeer 400 en 401 fouten niet opnieuw - die vereisen het repareren van het verzoek zelf.

Best practices voor productiegebruik

Frequentiebeperkingen

Standaard frequentielimieten bieden redelijke productiethroughput. Als u hogere limieten nodig hebt, neem contact op met ondersteuning met uw use case details.

Implementeer exponentiële backoff op 429 fouten:

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

Creditbeheer

Monitor het veld credits_remaining in elk antwoord. Stel waarschuwingen in wanneer het saldo onder een drempel daalt, zodat u kunt bijvullen voordat productieverkeer nul credits bereikt.

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

Asynchrone afhandeling

Voor gebruikersgerichte toepassingen behandelt u afbeeldingsgeneratie als async. Blokkeer het UI-thread niet op een 5-15 seconde API-aanroep. Patronen:

• Een taak-ID onmiddellijk retourneren, pollen op voltooiing
• Webhooks gebruiken (indien ondersteund) voor voltooiingsmeldingen
• Speculatief in de achtergrond genereren en resultaten in cache plaatsen

Caching

Gegenereerde afbeeldingen zijn deterministisch met dezelfde prompt en seed. Cache agressief door prompthash om te voorkomen dat identieke afbeeldingen opnieuw worden gegenereerd.

import hashlib

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

Promptveiligheid

Als uw app prompts aan eindgebruikers blootstelt, implementeert u inhoudsfiltering voordat u naar de API verzendt. Arteza heeft beleid voor inhoud - prompts die dit schenden, retourneren fouten, verspillen credits en creëren gebruikersgerichte fouten.

Prijzen voor API-gebruik

API-gebruik haalt van uw accounttegoedsaldo met dezelfde snelheid als webgebruik.

Credits komen uit dezelfde prijsniveaus ongeacht of u ze via web of API gebruikt:

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

Klanten met hoger volume kunnen contact opnemen met ondersteuning voor volumeprijzen voor aanhoudend gebruik boven 100.000 afbeeldingen/maand.

Combineren met andere Arteza-modellen

Uw toepassing kan meerdere Seedance-modellen via dezelfde API gebruiken door de model parameter te wijzigen:

• seedream-v4-5 - 8 credits - flagship kwaliteit
• seedream-v3 - 6 credits - sneller, eenvoudiger
• seedream-5-lite - 7 credits - deep thinking modus
• seedream-5-edit - 7 credits - afbeelding bewerken
• seedance-2 - videogeneratie (ander eindpunt)

Voor toepassingen die naast generatie ook bewerkingsmogelijkheden nodig hebben, verwerkt seedream-5-edit tekstgebaseerde afbeeldingsbewerkingen. Zie de Seedream 5 Edit documentatie voor details.

Beveiligingsoverwegingen

Stel API-sleutels nooit client-side bloot. Route API-aanroepen altijd via uw backend. Blootgestelde sleutels kunnen worden gebruikt om uw tegoedsaldo leeg te maken.

Draai sleutels regelmatig. Als een sleutel is gecompromitteerd, trekt u deze in en genereert u een nieuwe.

Logverzoeken voor foutopsporing. Neem verzoek-ID's in uw logboeken op, zodat u fouten kunt correleren met API-antwoorden.

Implementeer gebruiksquota per gebruiker. Als uw app AI-generatie als functie aanbiedt, beperkt u verbruik per gebruiker om misbruik te voorkomen.

Veelgestelde vragen

Bestaat er een gratis laag voor de API? Uw 50 aanmeldingscredits werken op API-aanroepen. Dit zijn 6 gratis Seedream v4.5 generaties om integratie te testen voordat u betaalt.

Wat is de typische reactietijd? 5-15 seconden voor Seedream v4.5 afhankelijk van resolutie en huidige belasting.

Kan ik de API gebruiken voor commerciële producten? Ja. Commercieel gebruik is inbegrepen. De gegenereerde afbeeldingen van uw klanten zijn van hen en kunnen voor elk legitiem doel worden gebruikt.

Is er een Python SDK? Officiële SDK's zijn in ontwikkeling. De huidige REST API werkt schoon met standaard HTTP-bibliotheken in elke taal.

Hoe ga ik om met content policy-fouten? Implementeer gebruikersgerichte berichten die uitleggen dat de prompt is afgewezen. Log de specifieke fout voor foutopsporing.

Wat gebeurt er als mijn credits halverwege een verzoek op raken? De API retourneert een 402 fout voordat generatie begint. Gedeeltelijke kosten treden nooit op - u krijgt of de volledige afbeelding of een fout.

Kan ik meerdere prompts in een verzoek batchsgewijs verwerken? Niet direct. Gebruik num_images: 6 om variaties van dezelfde prompt te krijgen, of maak parallelle API-aanroepen voor verschillende prompts.

---

De Seedream v4.5 API geeft u productie-klare AI-afbeeldingsgeneratie met voorspelbare per-afbeelding prijsstelling met standaard REST-conventies. Voor de meeste integraties kunt u binnen 10 minuten van API-sleutel naar eerste werkende generatie gaan. Voor vragen of volumeprijzen, neem contact op via uw accountdashboard.

Begin vandaag met integreren. Krijg je API-sleutel → | Bekijk volledige prijzen → | Lees de v4.5-gids →