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"
}
}
Z-Image-Turbo
Génération d'images Z-Image-Turbo
- Mode de traitement asynchrone, retourne un identifiant de tâche pour les requêtes ultérieures
- Génération d’images légère et rapide, prend en charge le chinois et l’anglais
- Prend en charge les niveaux de résolution 1K/2K, prend en charge la réécriture intelligente du prompt
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": "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 avecomni-moderation-latestfalseou 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:33:4— Portrait 3:416:9— Paysage écran large9:16— Portrait vertical3:2— Paysage 3:22: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 combinaisonsize (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"
}
{
"model": "z-image-turbo",
"prompt": "Minimalist style cafe interior design",
"size": "16:9",
"resolution": "2K"
}
{
"model": "z-image-turbo",
"prompt": "A cat",
"prompt_extend": true
}
Response
integer
Code de statut de la réponse
array
Remarques
- Traitement asynchrone : après la soumission, un
task_idest 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
nn’est pas pris en charge