Documentation de l’API Seedream 5.0 Flash
Tout ce dont vous avez besoin pour appeler Seedream 5.0 Flash depuis votre code. URL de base : https://cheapergen.com/api/v1. Essayez d’abord dans l’interface playground.
Vous utilisez un agent de programmation ?
Collez ceci dans Claude Code, Cursor, Codex ou tout autre agent de programmation. Il ajoute l’API à votre projet, conserve la clé dans CHEAPERGEN_API_KEY et teste le devis gratuit avant toute dépense.
Add Seedream 5.0 Flash (CheaperGen endpoint bytedance/ seedream-5.0-flash/ text-to-image) to this project by following https:/ / cheapergen.com/ agents/ integrate.mdAuthentification
Créez une clé dans Tableau de bord → Clés API et envoyez-la comme jeton Bearer. Conservez les clés côté serveur.
export CHEAPERGEN_API_KEY="cg_live_…"
# every request
Authorization: Bearer $CHEAPERGEN_API_KEYAPI Seedream 5.0 Flash Texte en image
/api/v1/run/bytedance/seedream-5.0-flash/text-to-imageEnvoie une tâche asynchrone et renvoie 202 avec un ID de génération. Interrogez GET /api/v1/generations/{id} ou indiquez webhook_url. Voir cycle de vie des tâches.
Paramètres d’entrée
| Nom | Type | Description | Influe sur le prix |
|---|---|---|---|
promptrequis | string | Décrivez le plan : sujet, action, mouvement de caméra, éclairage et style. | Non |
aspect_ratio | string (enum) | Format de l’image de sortie. Valeurs : 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 21:9 Par défaut : 1:1 | Oui |
size | string (enum) | 1K ≈ 1 mégapixel, 2K ≈ 4 mégapixels. Valeurs : 1K · 2K Par défaut : 2K | Oui |
seed | integer | Réutilisez le même seed et les mêmes paramètres pour reproduire un résultat. Laissez ce champ vide pour une valeur aléatoire. | Non |
webhook_url | chaîne (URL) | Facultatif. Nous envoyons la génération terminée par POST à cette adresse, avec une signature calculée à l’aide de votre secret de webhook. Webhooks | Non |
Requête
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/bytedance/seedream-5.0-flash/text-to-image`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Photo éditoriale d’une machine à espresso noire mate sur du travertin, lumière douce de fenêtre, 85 mm",
"aspect_ratio": "1:1",
"size": "2K"
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.images[0].url : job.error);Réponse
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "bytedance/seedream-5.0-flash",
"endpoint": "bytedance/seedream-5.0-flash/text-to-image",
"mode": "text-to-image",
"status": "queued",
"input": {
"prompt": "Photo éditoriale d’une machine à espresso noire mate sur du travertin, lumière douce de fenêtre, 85 mm",
"aspect_ratio": "1:1",
"size": "2K"
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}API Seedream 5.0 Flash Retouche d’image
/api/v1/run/bytedance/seedream-5.0-flash/editEnvoie une tâche asynchrone et renvoie 202 avec un ID de génération. Interrogez GET /api/v1/generations/{id} ou indiquez webhook_url. Voir cycle de vie des tâches.
Paramètres d’entrée
| Nom | Type | Description | Influe sur le prix |
|---|---|---|---|
promptrequis | string | Décrivez le plan : sujet, action, mouvement de caméra, éclairage et style. | Non |
image_urlsrequis | string[] (URLs) | Jusqu’à 10 images à retoucher ou à combiner. Mentionnez-les dans le prompt comme « image 1 », « image 2 »… Nombre maximal d’éléments : 10 | Non |
aspect_ratio | string (enum) | Format de l’image de sortie. Valeurs : 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 21:9 Par défaut : 1:1 | Oui |
size | string (enum) | 1K ≈ 1 mégapixel, 2K ≈ 4 mégapixels. Valeurs : 1K · 2K Par défaut : 2K | Oui |
seed | integer | Réutilisez le même seed et les mêmes paramètres pour reproduire un résultat. Laissez ce champ vide pour une valeur aléatoire. | Non |
webhook_url | chaîne (URL) | Facultatif. Nous envoyons la génération terminée par POST à cette adresse, avec une signature calculée à l’aide de votre secret de webhook. Webhooks | Non |
Requête
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/bytedance/seedream-5.0-flash/edit`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Remplacez l’arrière-plan par une terrasse méditerranéenne ensoleillée ; conservez le produit à l’identique",
"image_urls": [
"https://cdn.cheapergen.com/samples/portrait.jpg"
],
"aspect_ratio": "1:1",
"size": "2K"
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.images[0].url : job.error);Réponse
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "bytedance/seedream-5.0-flash",
"endpoint": "bytedance/seedream-5.0-flash/edit",
"mode": "edit",
"status": "queued",
"input": {
"prompt": "Remplacez l’arrière-plan par une terrasse méditerranéenne ensoleillée ; conservez le produit à l’identique",
"image_urls": [
"https://cdn.cheapergen.com/samples/portrait.jpg"
],
"aspect_ratio": "1:1",
"size": "2K"
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Récupérer le résultat
Les générations sont asynchrones. Interrogez leur état jusqu’à ce que status soit succeeded, failed ou canceled, ou indiquez webhook_url lors de l’envoi. Les générations échouées sont automatiquement remboursées.
curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY"Pour en savoir plus : cycle de vie des tâches · webhooks · erreurs
Tarifs de Seedream 5.0 Flash
Payez par image à l’usage, sans abonnement requis (forfaits mensuels facultatifs). Les générations échouées sont remboursées automatiquement.
| Offre | Prix officiel | CheaperGen | Vous économisez |
|---|---|---|---|
1K ≈1 MP | $0,0154/img | −14% | |
2K ≈4 MP | $0,0154/img | −14% |
- Prix officiel : Prix catalogue international de BytePlus ModelArk pour dola-seedream-5-0-flash ($0.018 par image). Tarifs vérifiés le 18 octobre 2026.