Seedream 5.5 API

Vollständige API-Referenz für die Seedream-5.5-Modelle von ByteDance.

Modellvarianten

Die API unterstützt zwei Modellvarianten:

Kurzvergleich

Unterstützte Seitenverhältnisse

16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9

Seedream 5.5 (Text zu Bild)

Endpunkt

POST /api/v1/image/task

Anfrageparameter

Pflichtparameter

Hinweis: Das Verhältnis von Breite zu Höhe muss einem der folgenden Werte entsprechen: 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9

Optionale Parameter

Beispielanfrage

javascriptKopieren
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedream-v5.5',
    prompt: 'Editorial fashion portrait, soft window light, muted palette',
    resolution: '1.5k',
    width: 16,
    height: 9,
    background: 'auto'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedream 5.5 Edit (Bildbearbeitung)

Endpunkt

POST /api/v1/image/task

Anfrageparameter

Pflichtparameter

Hinweis: Das Verhältnis von Breite zu Höhe muss einem der folgenden Werte entsprechen: 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9

Optionale Parameter

Beispielanfrage

javascriptKopieren
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedream-v5.5-edit',
    prompt: 'Change the hairstyle',
    image_url_list: [
      'https://img.bestimage.ai/test/2026/7/1/ad8e011a-3e9b-49f0-9397-282bf51e2e45_162640331.jpeg'
    ],
    resolution: '1.5k',
    width: 16,
    height: 9,
    background: 'auto'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Beispiel für die Bearbeitung eines einzelnen Bildes

javascriptKopieren
{
  model_name: 'seedream-v5.5-edit',
  image_url_list: ['https://img.bestimage.ai/test/2026/7/1/ad8e011a-3e9b-49f0-9397-282bf51e2e45_162640331.jpeg'],
  prompt: 'Change the hairstyle',
  resolution: '1.5k',
  width: 16,
  height: 9,
  background: 'auto'
}

Beispiel für die Bearbeitung mehrerer Bilder

javascriptKopieren
{
  model_name: 'seedream-v5.5-edit',
  image_url_list: [
    'https://example.com/image1.jpg',
    'https://example.com/image2.jpg'
  ],
  prompt: 'Blend these images into a cohesive composition',
  resolution: '1.5k',
  width: 16,
  height: 9,
  background: 'auto'
}

Antwortformat

Erste Antwort

jsonKopieren
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "0ca5f379-327b-4d49-ba19-e38782ceb2f0",
    "response_url": "https://api.flaq.ai/api/v1/image/0ca5f379-327b-4d49-ba19-e38782ceb2f0",
    "task_status": "submitted"
  }
}

Antwort auf eine Statusabfrage

Rufen Sie GET /api/v1/image/{task_id} wiederholt auf, um den Status zu prüfen:

jsonKopieren
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_result": {
      "credit": 200,
      "images": [
        {
          "url": "https://example.com/generated-image.png"
        }
      ]
    }
  },
  "message": "success"
}

Fehlerantwort

jsonKopieren
{
  "code": 1201,
  "message": "[width, height] Invalid parameter (e.g. wrong key or value)",
  "data": null
}

Statuswerte

• submitted: Aufgabe angenommen
• processing: Bildgenerierung läuft
• succeed: Bildgenerierung abgeschlossen
• failed: Bildgenerierung fehlgeschlagen

Verarbeitungszeit

Fragen Sie den Status wiederholt ab, bis er succeed oder failed lautet. Bei einer eingereichten oder noch laufenden Aufgabe enthält die Antwort möglicherweise noch keine Bilder.

Empfehlungen

1. Detaillierte Prompts: Präzise Beschreibungen führen zu besseren Ergebnissen
2. Seitenverhältnis: Wählen Sie vor der Generierung ein zum Einsatzzweck passendes Seitenverhältnis
3. Qualität der Ausgangsbilder: Verwenden Sie für die Bearbeitung gut ausgeleuchtete, hochauflösende Bilder