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

At integrere AI-billedgenerering i din app betød tidligere, at du skulle vælge mellem tre dårlige muligheder: køre Stable Diffusion selv (dyr infrastruktur), betale OpenAI per-token-priser (uforudsigelige omkostninger) eller forpligte dig til et abonnements-API (spildt kapacitet). Seedream v4.5 API er bygget anderledes: betal per billede til $0,10, 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'et er godt til

Seedream v4.5 API passer til applikationer, der har brug for AI-billedgenerering on-demand med forudsigelige priser per billede. Almindelige anvendelsestilfælde:

SaaS-produkter, der lader brugere generere billeder som del af deres arbejdsgang: designværktøjer, marketingplatforme og apps til indholdsskabelse.

E-handelsplatforme, der programmatisk genererer lifestyle-billeder af produkter eller kategoriheadere.

Marketingautomatiseringsværktøjer, der producerer kampagnevisuals baseret på strukturerede input.

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

Udviklerprojekter og automatiseringsscripts til enhver arbejdsgang, der har brug for billedgenerering i stor skala.

Mobilapps, der kalder API'et fra en backend-tjeneste for at holde billedgenereringen væk fra enheden.

Hvis dit anvendelsestilfælde matcher et af disse, vil denne guide få dig integreret hurtigt.

Godkendelse og kom i gang

Trin 1: Få en API-nøgle

Tilmeld dig for en Arteza-konto, hvis du ikke har en. Gå 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 credits til din konto

API-brug trækker fra den samme creditbalance som webbrug. Dine 10 gratis tilmeldingscredits virker på API-kald. Til produktionsbrug kan du abonnere fra prisside, som starter ved $5.

Trin 3: Lav din første forespørgsel

API-endpointet for Seedream v4.5 er:

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

Minimum request body:

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

Fuld parameterreference

Understøttede opløsninger

Seedream v4.5 understøtter flere opløsningsmuligheder op til 4 megapixels:

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

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

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

Billed-URL'er er gyldige i 24 timer. Download og gem billeder straks, hvis du har brug for permanent adgang.

Vil du have detaljer som disse? Prøv Seedream v4.5 gratis →

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

Fejlhåndtering

API'et returnerer standard HTTP-statuskoder:

Eksempel på 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 gentagne forsøg for 429- og 500-fejl. Prøv ikke igen ved 400- og 401-fejl: de kræver, at selve forespørgslen rettes.

Best practices til produktionsbrug

Hastighedsbegrænsning

Standardhastighedsgrænser tillader rimelig produktionsgennemstrømning. Hvis du har brug for højere grænser, skal du kontakte support med oplysninger om dit anvendelsestilfælde.

Implementer eksponentiel backoff ved 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")

Creditstyring

Overvåg feltet credits_remaining i hvert svar. Opsæt advarsler, når saldoen falder under en tærskel, så du kan fylde op, før produktionstrafikken løber tør for credits.

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

Asynkron håndtering

Til brugervendte applikationer bør du behandle billedgenerering som asynkron. Bloker ikke UI-tråden på et API-kald, der tager 5-15 sekunder. Mønstre:

• Returner et job-ID straks og poll efter fuldførelse
• Brug webhooks (hvis understøttet) til fuldførelsesbeskeder
• Generer spekulativt i baggrunden og cache resultater

Caching

Genererede billeder er deterministiske givet den samme prompt og seed. Cache aggressivt via 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()

Promptsikkerhed

Hvis din app eksponerer prompts for slutbrugere, skal du implementere indholdsfiltrering, inden du sender til API'et. Arteza har indholdspolitikker: prompts, der overtræder dem, returnerer fejl, som spilder credits og skaber synlige fejl for brugerne.

Priser for API-brug

API-brug trækker fra din kontos creditbalance til samme sats som webbrug.

Credits kommer fra det samme prisniveauer, uanset om du bruger dem via web eller API:

• Starter: $5 = 60 credits om måneden = 60 billeder
• Creator: $25 = 300 credits om måneden = 300 billeder
• Pro: $50 = 700 credits om måneden = 700 billeder
• Studio: $120 = 1.800 credits om måneden = 1.800 billeder

Kunder med højere volumen kan kontakte support om volumenpris ved vedvarende brug over 100.000 billeder/måned.

Kombination med andre Arteza-modeller

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

• seedream-v4-5 - 1 credits - flagskibskvalitet
• seedream-v3 - 1 credit - hurtigere og enklere
• seedream-5-lite - 1 credit - dybt tænkningstilstand
• seedream-5-edit - 1 credit - billedredigering
• seedance-2 - videogenerering (andet endpoint)

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

Sikkerhedshensyn

Eksponér aldrig API-nøgler på klientsiden. Rut altid API-kald gennem din backend. Eksponerede nøgler kan bruges til at dræne din creditbalance.

Roter nøgler periodisk. Hvis en nøgle er kompromitteret, skal du tilbagekalde den og generere en ny.

Log forespørgsler til fejlfinding. Inkluder forespørgsels-ID'er i dine logs, så du kan korrelere fejl med API-svar.

Implementer brugskvota per bruger. Hvis din app tilbyder AI-generering som en funktion, skal du begrænse forbrug per bruger for at forhindre misbrug.

Ofte stillede spørgsmål

Er der et gratis niveau til API'et? Dine 10 tilmeldingscredits virker på API-kald. Det er 10 gratis Seedream v4.5-genereringer til at teste integration, inden du betaler.

Hvad er den typiske svartid? 5-15 sekunder for Seedream v4.5 afhængigt af opløsning og aktuel belastning.

Kan jeg bruge API'et til kommercielle produkter? Ja. Kommerciel brug er inkluderet. Dine kunders genererede billeder tilhører dem og kan bruges til ethvert lovligt formål.

Er der et Python SDK? officielle SDK'er er under udvikling. Det nuværende REST API fungerer rent med standard HTTP-biblioteker i alle sprog.

Hvordan håndterer jeg indholdspolitikfejl? Implementer brugervendte beskeder, der forklarer, at prompten blev afvist. Log den specifikke fejl til fejlfinding.

Hvad sker der, hvis mine credits løber op midt i en forespørgsel? API'et returnerer en 402-fejl, inden genereringen starter. Der forekommer aldrig delvise gebyrer: du får enten det fulde billede eller en fejl.

Kan jeg batch-behandle flere prompts i én forespørgsel? Ikke direkte. Brug num_images: 6 til at få variationer af den samme prompt, eller lav parallelle API-kald til forskellige prompts.

---

Seedream v4.5 API giver dig produktionsklar AI-billedgenerering til forudsigelige priser per billede 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 volumenpris kan du henvende dig via dit kontodashboard.

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