Langsung ke konten utama
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"
  }
}

Model yang Didukung

ModelDeskripsiGambar per PermintaanHarga
z-image-turboPembuatan gambar ringan dan cepat, mendukung bahasa Mandarin dan InggrisTetap 1 gambarHarga tetap

Otorisasi

Authorization
string
wajib
Semua endpoint memerlukan autentikasi Bearer TokenDapatkan API Key:Kunjungi Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header permintaan:
Authorization: Bearer YOUR_API_KEY

Body

model
string
wajib
Nama model
  • z-image-turbo - Pembuatan gambar ringan dan cepat, mendukung bahasa Mandarin dan Inggris
prompt
string
wajib
Deskripsi teks untuk pembuatan gambar, hingga 800 karakter
size
string
default:"1:1"
Rasio aspek gambarRasio aspek yang didukung:
  • 1:1 - Persegi (default)
  • 4:3 - Lanskap 4:3
  • 3:4 - Potret 3:4
  • 16:9 - Lanskap layar lebar
  • 9:16 - Potret vertikal
  • 3:2 - Lanskap 3:2
  • 2:3 - Potret 2:3
resolution
string
default:"1K"
Tier resolusi
  • 1K - Resolusi standar (default)
  • 2K - Resolusi definisi tinggi
prompt_extend
boolean
default:"false"
Penulisan ulang prompt cerdasSaat diaktifkan, AI akan otomatis mengoptimalkan prompt untuk hasil yang lebih baik, dan biaya akan meningkat.
  • false - Dinonaktifkan (default)
  • true - Aktifkand

Tabel Referensi Resolusi

Ukuran output dikendalikan oleh kombinasi size (rasio) + resolution (tier resolusi).
Rasio1K Tier2K Tier
1:11024×10242048×2048
4:31152×8642048×1536
3:4864×11521536×2048
16:91280×7202048×1152
9:16720×12801152×2048
3:21248×8322048×1360
2:3832×12481360×2048

Contoh Penggunaan

Text-to-Image Dasar (permintaan minimal)
{
  "model": "z-image-turbo",
  "prompt": "Ink painting style landscape scenery"
}
Tentukan rasio dan resolusi
{
  "model": "z-image-turbo",
  "prompt": "Minimalist style cafe interior design",
  "size": "16:9",
  "resolution": "2K"
}
Aktifkan penulisan ulang prompt cerdas
{
  "model": "z-image-turbo",
  "prompt": "A cat",
  "prompt_extend": true
}

Respons

code
integer
Kode status respons
data
array
Array data respons

Catatan

  1. Pemrosesan Asinkron: Setelah pengiriman, task_id dikembalikan. Polling /v1/tasks/{task_id} untuk mendapatkan hasil
  2. Penyimpanan Gambar: Gambar yang dihasilkan dicerminkan ke CDN platform dan berlaku jangka panjang
  3. Aturan Penagihan: Ditagih per gambar yang berhasil dibuat; tidak ada biaya untuk kegagalan
  4. Jumlah Tetap: Z-Image-Turbo membuat tepat 1 gambar per permintaan, n parameter tidak didukung