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-seedream-5-0-lite",
    "prompt": "A golden retriever playing in a garden, sunny day, high-definition photography style",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "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-seedream-5-0-lite",
    "prompt": "A golden retriever playing in a garden, sunny day, high-definition photography style",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "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-seedream-5-0-lite"
requis
Nom du modèle de génération d’imagesModèles pris en charge : doubao-seedream-5-0-lite, doubao-seedream-5.0-lite, Doubao-Seedream-5.0-liteExemple : "doubao-seedream-5-0-lite"
​
prompt
string
requis
Description textuelle pour la génération d’images
​
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
  • auto — Adaptation automatique au rapport d’aspect de l’image de référence (nécessite image_urls)
Remarque : Seedream-5.0-Lite ne prend pas en charge le rapport 9:21
​
resolution
string
défaut:"2K"
Résolution de l’imageRésolutions prises en charge :
  • 2K — Résolution standard (par défaut)
  • 3K — Haute définition
Remarque : Seedream-5.0-Lite ne prend en charge que les résolutions 2K et 3K, les résolutions 1K et 4K ne sont pas prises en charge
Tailles de référence par résolution :
RésolutionTaille 1:1Taille 16:9
2K2048x20482848x1600
3K3072x30724096x2304
​
n
integer
Nombre d’images à générerPlage : 1–4Par défaut : 1Remarque :
  • Lorsque n > 1, le mode de génération séquentielle est automatiquement activé
  • 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-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,{base64data}
  • 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
Limitations :
  • 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 par image
  • Pixels totaux : ne dépassant pas 6000×6000 px
​
output_format
string
défaut:"jpeg"
Format de l’image de sortie
  • jpeg : format JPEG (par défaut)
  • png : format PNG, adapté aux arrière-plans transparents et cas similaires
Remarque : Le paramètre output_format est exclusif à Seedream-5.0-Lite. Les autres modèles d’image ignorent ce paramètre.
​
sequential_image_generation
string
défaut:"disabled"
Mode de génération séquentielle d’imagesContrôle la génération de plusieurs images :
  • disabled : désactive le mode séquentiel (par défaut)
  • auto : active le mode séquentiel, peut générer plusieurs images
Notes d’utilisation :
  • Lorsque n > 1, ce paramètre est automatiquement défini sur auto
​
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
Exemple :
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 4
}
​
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