Documentation développeur

Documentation API de Seedream 5 Pro

Créez des images avec Seedream 5 Pro via l’API asynchrone de ce site. Seedream 5.5 reste en préversion et ne peut pas encore être appelé ici.

Démarrage rapide

Créez une clé dans la rubrique des clés API de votre espace de travail.
Envoyez model=seedream-5-pro et une instruction à POST /api/v1/images/generate.
Utilisez le data.task_id reçu pour interroger GET /api/v1/images/status?task_id=TASK_ID avec la même clé API.

Authentification

Envoyez Authorization: Bearer YOUR_API_KEY depuis votre serveur. Aucune session de navigateur ni aucun Cookie ne sont requis. Gardez votre clé API secrète.

Authorization: Bearer YOUR_API_KEY

Points de terminaison et champs de requête

POST /api/v1/images/generate

Envoyez un corps JSON avec model, prompt, aspect_ratio et resolution (1k ou 2k). Le champ facultatif image_urls accepte jusqu’à 10 URL de référence ; public est un booléen facultatif. La réponse contient code, message et data avec task_id et status.

GET /api/v1/images/status?task_id=TASK_ID

L’interrogation avec task_id renvoie code, message et data contenant task_id, status, consumed_credits et image_urls (un tableau d’URL d’images). error_message peut être présent en cas d’échec.

Le seul modèle disponible via cet API est seedream-5-pro

Continuez à interroger pendant le traitement, puis lisez image_urls à la fin ou error_message en cas d’échec.

Exemple cURL

Copiez les commandes dans votre terminal, remplacez YOUR_API_KEY par votre clé API privée, puis TASK_ID par data.task_id de la première réponse.

curl -X POST https://seedream5-5ai.com/api/v1/images/generate -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' --data '{"model":"seedream-5-pro","prompt":"Une affiche de café avec des inscriptions claires et lisibles","aspect_ratio":"1:1","resolution":"1k","image_urls":[],"public":false}'

curl 'https://seedream5-5ai.com/api/v1/images/status?task_id=TASK_ID' -H 'Authorization: Bearer YOUR_API_KEY'