Seedream v4.5 API: Integrer AI-billeder i din app

Integrering af AI-billedgenerering i din app plejede at betyde at vælge mellem tre dårlige muligheder: køre Stable Diffusion selv (dyr infrastruktur), betale OpenAI per-token-satser (uforudsigelige omkostninger) eller forpligte dig til en abonnements-API (spildt kapacitet). Seedream v4.5 API er bygget anderledes - betalt per billede for $0,08, standard REST og svartider målt i sekunder. Denne guide får dig fra nul til første generering på under 10 minutter.

Hvad API'en er god til

Seedream v4.5 API passer til applikationer, der har brug for on-demand AI-billedgenerering med forudsigelige omkostninger per billede. Almindelige use cases:

SaaS-produkter, der lader brugere generere billeder som del af deres arbejdsgang - designværktøjer, markedsføringsplatforme, indholdskreationsapps.

E-commerce-platforme, der genererer produktlivsstil-billeder eller kategoriheder programmatisk.

Markedsføringsautomation-værktøjer, der producerer kampagnevisualer baseret på strukturerede input.

Indholdsstyringssystemer, der tilbyder AI-billedgenerering som en native funktion.

Udvikler-projekter og automatiseringsskripter til enhver arbejdsgang, der har brug for billedgenerering i stor skala.

Mobile apps, der kalder API'en fra en backend-tjeneste for at holde billedgenereringen off-device.

Hvis dit use case matcher nogen af disse, vil denne guide få dig integreret hurtigt.

Godkendelse og introduktion

Trin 1: Få en API-nøgle

Tilmeld dig for en Arteza-konto, hvis du ikke allerede har en. Naviger til dine kontoindstillinger og generer en API-nøgle. Behandl denne nøgle som en adgangskode - commit den ikke til offentlige repositories.

Trin 2: Tilføj kreditter til din konto

API-brug trækker fra den samme kreditsaldo som webforbrug. Dine 50 gratis tilmeldingskreditter fungerer på API-kald. Til produktionsbrug skal du abonnere fra prisside startende ved $10.

Trin 3: Foretag din første anmodning

API-slutpunktet for Seedream v4.5 er:

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

Minimum anmodningsbrødtekst:

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

Inkluder din API-nøgle i Authorization-headeren:

Authorization: Bearer YOUR_API_KEY

Komplet parameterreferencer

Understøttede opløsninger

Seedream v4.5 understøtter flere opløsningsindstillinger op til 4 megapixel:

Kodeeksempler

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
}

Svarformat

Vellykkede svar returnerer JSON med denne struktur:

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

Billede-URL'er er gyldige i 24 timer. Download og gem billeder med det samme, hvis du har brug for permanent adgang.

Vil du have denne detalje? Prøv Seedream v4.5 gratis →

Klar til at begynde at integrere? Få din API-nøgle →

Fejlhåndtering

API'en returnerer standard HTTP-statuskoder:

Eksempel-fejlsvar:

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

Implementer altid fejlhåndtering og forsøg igen for 429 og 500 fejl. Forsøg ikke igen 400 og 401 fejl - de kræver at rette selve anmodningen.

Bedste praksis til produktionsbrug

Hastighedsbegrænsning

Standard hastighedsbegrænser tillader rimelig produktionsthroughput. Hvis du har brug for højere grænser, kontakt support med dine use case-detaljer.

Implementer eksponentiel backoff på 429 fejl:

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

Kreditstyring

Overvåg credits_remaining-feltet i hvert svar. Opsæt advarsler, når saldoen falder under en tærskel, så du kan fylde op før produktionstrafik rammer nul kreditter.

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

Asynkron håndtering

For brugervendte applikationer skal du behandle billedgenerering som asynkron. Blok ikke UI-tråden på et 5-15 sekunders API-kald. Mønstre:

• Returnér straks et job-ID, poll for afslutning
• Brug webhooks (hvis understøttet) til afslutningsmeddelelser
• Generer spekulativt i baggrunden og cach resultater

Caching

Genererede billeder er deterministiske givet samme prompt og seed. Cache aggressivt efter prompt-hash for at undgå at regenerere identiske billeder.

import hashlib

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

Prompt-sikkerhed

Hvis din app viser prompts for slutbrugere, implementer indholdsfiltrering før afsendelse til API'en. Arteza har indholdspolitikker - prompts, der overtræder dem, returnerer fejl, hvilket spilder kreditter og skaber brugervendte fejl.

Prissætning for API-forbrug

API-forbrug trækker fra din kontos kreditsaldo med samme sats som webforbrug.

Kreditter kommer fra samme prisplaner uanset om du bruger dem via web eller API:

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

Kunder med højere volumen kan kontakte support om volumenpriser til vedvarende forbrug over 100.000 billeder/måned.

Kombinering med andre Arteza-modeller

Din applikation kan bruge flere Seedance-modeller gennem samme API ved at ændre model-parameteren:

• seedream-v4-5 - 8 kreditter - flagskib-kvalitet
• seedream-v3 - 6 kreditter - hurtigere, enklere
• seedream-5-lite - 7 kreditter - dybetænkningstilstand
• seedream-5-edit - 7 kreditter - billedredigering
• seedance-2 - videoGenerering (forskelligt slutpunkt)

For applikationer, der har brug for redigering ud over generering, håndterer seedream-5-edit tekstbaseret billedredigering. Se Seedream 5 Edit dokumentation for detaljer.

Sikkerhedshensyn

Udsæt aldrig API-nøgler klientside. Rut altid API-kald gennem din backend. Eksponerede nøgler kan bruges til at dræne din kreditsaldo.

Roter nøgler periodisk. Hvis en nøgle er kompromitteret, tilbagekald den og generer en ny.

Log anmodninger til fejlfinding. Inkluder anmodnings-ID'er i dine logs, så du kan korrelere fejl med API-svar.

Implementer brugerkvoter. Hvis din app tilbyder AI-generering som en funktion, begræns forbrug per bruger for at forhindre misbrug.

Ofte stillede spørgsmål

Er der et gratis niveau for API'en? Dine 50 tilmeldingskreditter fungerer på API-kald. Det er 6 gratis Seedream v4.5-genereringer for at teste integrationen før betaling.

Hvad er typisk svartid? 5-15 sekunder for Seedream v4.5 afhængigt af opløsning og nuværende belastning.

Kan jeg bruge API'en til kommercielle produkter? Ja. Kommerciel brug er inkluderet. Dine kunders genererede billeder er deres til brug til ethvert lovligt formål.

Er der en Python SDK? Official SDK'er er under udvikling. Den nuværende REST API fungerer rent med standard HTTP-biblioteker på ethvert sprog.

Hvordan håndterer jeg fejl i indholdspolitik? Implementer brugervendte meddelelser, der forklarer at promptet blev afvist. Log den specifikke fejl til fejlfinding.

Hvad sker der, hvis mine kreditter løber ud midt i en anmodning? API'en returnerer en 402 fejl før generering starter. Delvis opladning forekommer aldrig - du får enten hele billedet eller en fejl.

Kan jeg batch flere prompts i en enkelt anmodning? Ikke direkte. Brug num_images: 6 for at få variationer af samme prompt, eller foretag parallelle API-kald for forskellige prompts.

---

Seedream v4.5 API giver dig produktionsklar AI-billedgenerering til forudsigelige per-billede-priser med standard REST-konventioner. For de fleste integrationer kan du gå fra API-nøgle til første fungerende generering på under 10 minutter. For spørgsmål eller volumenpriser, kontakt gennem dit kontooskab.

Begyn at integrere i dag. Få din API-nøgle → | Se fuld prissætning → | Læs v4.5-guiden →