Passer au contenu principal
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-4-0",
    "prompt": "A cute panda playing in a bamboo forest",
    "size": "1:1",
    "resolution": "2K",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/1761215838466614297_9852.png"
    ]
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-4-0",
    "prompt": "A cute panda playing in a bamboo forest",
    "size": "1:1",
    "resolution": "2K",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/1761215838466614297_9852.png"
    ]
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

​
Autorisations

​
Authorization
string
requis
Tous les points de terminaison de l’API nécessitent une authentification Bearer TokenObtenez votre clé API :Visitez la page de gestion des clés API pour obtenir votre clé APIAjoutez-la à l’en-tête de la requête :
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
défaut:"doubao-seedance-4-0"
requis
Nom du modèle de génération d’imagesModèles pris en charge : doubao-seedance-4-0, doubao-seedream-4.0, doubao-seedream-4-0, Doubao-Seedream-4.0Exemple : "doubao-seedance-4-0"
​
prompt
string
requis
Description textuelle pour la génération d’imagesMaximum 1000 caractères
​
size
string
défaut:"1:1"
Rapport d’aspect de l’imageRapports pris en charge :
  • 1:1 — Carré (par défaut)
  • 4:3 — Paysage 4:3
  • 3:4 — Portrait 3:4
  • 16:9 — Paysage écran large
  • 9:16 — Portrait vertical
  • 3:2 — Paysage 3:2
  • 2:3 — Portrait 2:3
  • 21:9 — Ultra-large
  • 9:21 — Ultra-haut
  • auto — Adaptation automatique au rapport d’aspect de l’image de référence (nécessite image_urls)
​
resolution
string
défaut:"2K"
Résolution de l’imageRésolutions prises en charge :
  • 1K — Résolution de base
  • 2K — Résolution standard (par défaut)
  • 4K — Haute définition
Tailles de référence par résolution :
RésolutionTaille 1:1Taille 16:9
1K1024x10241280x720
2K2048x20482560x1440
4K4096x40965404x3040
​
n
integer
Nombre d’images à générerPlage : 1–15 (minimum 1, maximum 15)Par défaut : 1Remarque :
  • Le nombre réel d’images pouvant être générées dépend à la fois de ce paramètre et du nombre d’images de référence fournies. La somme des images de référence et des images générées doit être ≤ 15
  • Vous devez saisir un nombre simple (par exemple, 1), n’utilisez pas de guillemets, sinon cela provoquera une erreur
Les frais seront pré-déduits en fonction du nombre
​
image_urls
array
Liste d’URL d’images de référence pour la génération image-vers-image ou l’édition d’imageDeux formats sont pris en charge :1. URL d’image complète
  • URL d’image publiquement accessible (http:// ou https://)
  • Exemple : https://example.com/image.jpg
2. Format encodé en Base64
  • Doit utiliser le format Data URI complet
  • Format : data:image/{format};base64,{base64-data}
  • Formats d’image pris en charge : jpeg, png
  • Exemple : data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • Remarque : le préfixe data:image/jpeg;base64, est obligatoire
Limites :
  • Maximum 10 images
  • Formats d’image : jpeg, png
  • Plage de rapport d’aspect (largeur/hauteur) : [1/3, 3]
  • Largeur et hauteur (px) > 14
  • Taille : ne dépassant pas 10 Mo
  • Pixels totaux : ne dépassant pas 6000×6000 px
​
optimize_prompt_options
string
défaut:"standard"
Mode d’optimisation du prompt
  • standard : mode standard, génère du contenu de meilleure qualité avec un temps de traitement plus long
  • fast : mode rapide, génère du contenu en moins de temps avec une qualité normale
Par défaut : standard
​
sequential_image_generation
string
défaut:"disabled"
Mode de génération séquentielle d’images (fonctionnalité spécifique à Doubao)Contrôle la génération de plusieurs images :
  • disabled : désactive le mode séquentiel, ne génère qu’une seule image même avec plusieurs images de référence (par défaut)
  • auto : active le mode séquentiel, peut générer plusieurs images
Notes d’utilisation :
  • Vous devez fournir image_urls — au moins 1 image de référence est requise
  • Définissez n: 3 ou utilisez sequential_image_generation: "auto" + max_images: 3
  • Cela générera 3 images différentes basées sur les images de référence
  • Lorsque n > 1, ce paramètre est automatiquement défini sur auto
Limitations :
  • La génération texte-vers-image pure (sans image_urls) ne peut pas générer plusieurs images — il s’agit d’une limitation de l’API Doubao
​
sequential_image_generation_options
object
Options de génération séquentielle d’imagesDisponible lorsque sequential_image_generation est défini sur autoPropriétés :
  • max_images (integer) : précise le nombre d’images à générer, plage : 1–15
Exemple :
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 3
}
​
watermark
boolean
défaut:"false"
Ajouter ou non un filigrane à l’image générée
  • true : ajouter un filigrane
  • false : pas de filigrane (par défaut)

​
Response

​
code
integer
Code de statut de la réponse
​
data
array
Tableau de données de la réponse