API d’images Seedream 5

Documentation API

Utilisez ces endpoints pour générer des images Seedream 5 de façon asynchrone. Les crédits dépendent de la qualité et du mode.

Authentification

Toutes les requêtes doivent inclure votre clé API dans l'en-tête Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Les clés manquantes ou invalides retournent 401 Unauthorized.

POST

https://seedream45ai.org/api/generate

Créer une tâche de génération

Soumet une nouvelle tâche Seedream 5. L'appel retourne immédiatement un task_id tandis que le rendu s'achève de manière asynchrone.

Paramètre	Type	Requis	Description
prompt	string (max 1500 chars)	Oui	Description textuelle principale (1500 caractères maximum). Requise pour chaque requête.
aspectRatio	string	Oui	Formats pris en charge : 1:1 · 3:4 · 4:3 · 9:16 · 16:9.
quality	string (basic \| high)	Oui	basic (rapide, 2K) ou high (plus détaillé, 4K).
imageUrls	string[]	Non	Images de référence facultatives. Requises en mode édition.

Consommation de crédits

Les crédits sont déduits lors de la création de la tâche. Les tâches échouées sont automatiquement remboursées.

Préréglage	Crédits déduits
Texte vers image · Basic	12
Texte vers image · High	18
Édition avec référence · Basic	18
Édition avec référence · High	24
Série de 4 images (un appel)	48

Exemple de requête

POST https://seedream45ai.org/api/generate
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
  "aspectRatio": "4:3",
  "quality": "high",
  "imageUrls": []
}

Exemple de réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71"
  }
}

GET / POST

https://seedream45ai.org/api/status

Vérifier le statut de la tâche

Utilisez ce point de terminaison pour interroger l'enregistrement le plus récent. Lorsque la tâche est toujours en statut IN_PROGRESS, nous interrogeons le fournisseur une fois de plus avant de répondre.

Paramètre	Type	Requis	Description
task_id	string	Oui	ID retourné par /generate. À transmettre à /status via la requête (?task_id=).

Champ	Description
task_id	ID retourné par /generate.
status	SUCCESS (SUCCÈS)
request	Copie nettoyée de la charge utile soumise.
response	Tableau des URL de médias lorsque le statut est SUCCESS.
consumed_credits	Crédits facturés pour la tâche (0 en cas de remboursement).
error_message	Erreur du fournisseur lorsque le statut est FAILED.
created_at	Horodatage UTC auquel la tâche a été enregistrée.

Exemple de requête

GET https://seedream45ai.org/api/status?task_id=sd5_b83bf7c0c51a4c71
Authorization: Bearer <YOUR_API_KEY>

Exemple de réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71",
    "status": "SUCCESS",
    "request": {
      "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
      "aspectRatio": "4:3",
      "quality": "high"
    },
    "response": [
      "https://watch_001.png"
    ],
    "consumed_credits": 12,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Gestion des erreurs

401 Unauthorized - Clé API manquante ou invalide.
402 Payment Required - Le solde de crédits n'a pas pu couvrir la déduction.
429 Too Many Requests - Réduisez la cadence de vérification ou le taux de requêtes.
500 - Problème transitoire ; réessayez avec un backoff exponentiel.