Génération d'images Z-Image-Turbo

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'

import requests

url = "https://api.apimart.ai/v1/images/generations"

payload = {
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/images/generations";

const payload = {
  model: "z-image-turbo",
  prompt: "Ink painting style landscape scenery",
};

const headers = {
  Authorization: "Bearer <token>",
  "Content-Type": "application/json",
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

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

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient balance, please top up",
    "type": "payment_required"
  }
}

POST

images

generations

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'

import requests

url = "https://api.apimart.ai/v1/images/generations"

payload = {
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/images/generations";

const payload = {
  model: "z-image-turbo",
  prompt: "Ink painting style landscape scenery",
};

const headers = {
  Authorization: "Bearer <token>",
  "Content-Type": "application/json",
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

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

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient balance, please top up",
    "type": "payment_required"
  }
}

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'

import requests

url = "https://api.apimart.ai/v1/images/generations"

payload = {
    "model": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/images/generations";

const payload = {
  model: "z-image-turbo",
  prompt: "Ink painting style landscape scenery",
};

const headers = {
  Authorization: "Bearer <token>",
  "Content-Type": "application/json",
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

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

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient balance, please top up",
    "type": "payment_required"
  }
}

Modèles pris en charge

Modèle	Description	Images par requête	Tarification
`z-image-turbo`	Génération d’images légère et rapide, prend en charge le chinois et l’anglais	1 image fixe	Prix fixe

Autorisations

string

requis

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

Authorization: Bearer YOUR_API_KEY

Body

string

requis

Nom du modèle

z-image-turbo — génération d’images légère et rapide, prend en charge le chinois et l’anglais

boolean

défaut:"false"

Indique s’il faut modérer le contenu avant d’envoyer la tâche d’image.

true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)

string

requis

Description textuelle pour la génération d’images, jusqu’à 800 caractères

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

string

défaut:"1K"

Niveau de résolution

1K — résolution standard (par défaut)
2K — résolution haute définition

boolean

défaut:"false"

Réécriture intelligente du promptLorsqu’elle est activée, l’IA optimise automatiquement le prompt pour de meilleurs résultats, et les coûts augmentent.

false — désactivé (par défaut)
true — activé

Tableau de référence des résolutions

La taille de sortie est contrôlée par la combinaison size (rapport) + resolution (niveau de résolution).

Rapport	Niveau 1K	Niveau 2K
`1:1`	1024×1024	2048×2048
`4:3`	1152×864	2048×1536
`3:4`	864×1152	1536×2048
`16:9`	1280×720	2048×1152
`9:16`	720×1280	1152×2048
`3:2`	1248×832	2048×1360
`2:3`	832×1248	1360×2048

Exemples d’utilisation

Texte-vers-image de base (requête minimale)

{
  "model": "z-image-turbo",
  "prompt": "Ink painting style landscape scenery"
}

Spécifier rapport et résolution

{
  "model": "z-image-turbo",
  "prompt": "Minimalist style cafe interior design",
  "size": "16:9",
  "resolution": "2K"
}

Activer la réécriture intelligente du prompt

{
  "model": "z-image-turbo",
  "prompt": "A cat",
  "prompt_extend": true
}

Response

integer

Code de statut de la réponse

array

Tableau de données de la réponse

Afficher Propriétés

string

Statut de la tâche

submitted — Soumise

string

Identifiant unique de la tâche

Remarques

Traitement asynchrone : après la soumission, un task_id est retourné. Interrogez /v1/tasks/{task_id} pour obtenir les résultats
Stockage des images : les images générées sont mises en miroir sur le CDN de la plateforme et sont valides à long terme
Règles de facturation : facturé par image générée avec succès, aucun frais en cas d’échec
Nombre fixe : Z-Image-Turbo génère exactement 1 image par requête, le paramètre n n’est pas pris en charge

Aperçu

Modèles

Série Texte

Série Image

Série Vidéo

Série Audio

Série Modération

Gestion des uploads

Gestion des tâches

Gestion du compte

Génération d'images Z-Image-Turbo

Modèles pris en charge

Autorisations

Body

Tableau de référence des résolutions

Exemples d’utilisation

Response

Remarques

​Modèles pris en charge

​Autorisations

​Body

​Tableau de référence des résolutions

​Exemples d’utilisation

​Response

​Remarques

Modèles pris en charge

Autorisations

Body

Tableau de référence des résolutions

Exemples d’utilisation

Response

Remarques