API de Seedream 5.5

Référence complète de l’API des modèles Seedream 5.5 de ByteDance.

Variantes du modèle

Cette API prend en charge deux variantes du modèle :

Comparaison rapide

Formats d’image pris en charge

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

Seedream 5.5 (génération d’images à partir de texte)

Point de terminaison

POST /api/v1/image/task

Paramètres de la requête

Obligatoires

Remarque : Le rapport largeur/hauteur doit être l’un des suivants : 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9

Facultatifs

Exemple de requête

javascriptCopier
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 (retouche d’images)

Point de terminaison

POST /api/v1/image/task

Paramètres de la requête

Obligatoires

Remarque : Le rapport largeur/hauteur doit être l’un des suivants : 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9

Facultatifs

Exemple de requête

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

Exemple de retouche d’une seule image

javascriptCopier
{
  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'
}

Exemple de retouche de plusieurs images

javascriptCopier
{
  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'
}

Format de réponse

Réponse initiale

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

Réponse aux requêtes de suivi

Interrogez régulièrement GET /api/v1/image/{task_id} pour vérifier l’état de la tâche :

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

Réponse d’erreur

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

Valeurs d’état

• submitted: Tâche acceptée
• processing: Génération d’image en cours
• succeed: Génération d’image terminée
• failed: Échec de la génération d’image

Délai de traitement

Interrogez l’API jusqu’à ce que l’état de la tâche soit succeed ou failed. Une tâche acceptée ou en cours de traitement peut ne pas encore contenir d’images.

Bonnes pratiques

1. Instructions détaillées : décrivez précisément l’image souhaitée pour obtenir de meilleurs résultats
2. Format d’image : choisissez le rapport adapté à l’usage prévu avant de générer l’image
3. Qualité de la retouche : utilisez des images sources bien éclairées et de haute résolution