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": "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"
    }
  ]
}

​
Otorisasi

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

​
Body

​
model
string
default:"doubao-seedream-5-0-lite"
wajib
Nama model pembuatan gambarModel yang didukung: doubao-seedream-5-0-lite, doubao-seedream-5.0-lite, Doubao-Seedream-5.0-liteContoh: "doubao-seedream-5-0-lite"
​
prompt
string
wajib
Deskripsi teks untuk pembuatan gambar
​
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
  • 21:9 - Ultra-lebar
  • auto - Otomatis mencocokkan rasio aspek gambar referensi (memerlukan image_urls)
Catatan: Seedream-5.0-Lite tidak mendukung rasio 9:21
​
resolution
string
default:"2K"
Resolusi gambarResolusi yang didukung:
  • 2K - Resolusi standar (default)
  • 3K - Definisi tinggi
Catatan: Seedream-5.0-Lite hanya mendukung resolusi 2K dan 3K; 1K dan 4K tidak didukung
Ukuran referensi resolusi:
Resolusi1:1 Ukuran16:9 Ukuran
2K2048x20482848x1600
3K3072x30724096x2304
​
n
integer
Jumlah gambar yang akan dibuatRentang: 1-4Default: 1Catatan:
  • Saat n > 1, mode pembuatan gambar sekuensial otomatis diaktifkan
  • Harus memasukkan angka biasa (misalnya 1), jangan gunakan tanda kutip karena akan menyebabkan error
Biaya akan dipotong di muka berdasarkan jumlah tersebut
​
image_urls
array
Daftar URL gambar referensi untuk pembuatan image-to-imageDua format didukung:1. URL gambar lengkap
  • URL gambar yang dapat diakses publik (http:// atau https://)
  • Contoh: https://example.com/image.jpg
2. Format berenkode Base64
  • Harus menggunakan format Data URI lengkap
  • Format: data:image/{format};base64,{base64data}
  • Format gambar yang didukung: jpeg, png
  • Contoh: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Catatan: Harus menyertakan prefiks data:image/jpeg;base64,
Batasan:
  • Format gambar: jpeg, png
  • Rentang rasio aspek (lebar/tinggi): [1/3, 3]
  • Lebar dan tinggi (px) > 14
  • Ukuran: tidak melebihi 10MB per gambar
  • Total piksel: tidak melebihi 6000×6000 px
​
output_format
string
default:"jpeg"
Format gambar output
  • jpeg: Format JPEG (default)
  • png: Format PNG, cocok untuk latar belakang transparan dan kasus penggunaan serupa
Catatan: Parameter output_format khusus untuk Seedream-5.0-Lite. Model gambar lain akan mengabaikan parameter ini.
​
sequential_image_generation
string
default:"disabled"
Mode pembuatan gambar sekuensialMengatur apakah akan membuat beberapa gambar:
  • disabled: Nonaktifkan mode sekuensial (default)
  • auto: Aktifkan mode sekuensial, dapat membuat beberapa gambar
Catatan Penggunaan:
  • Saat n > 1, nilainya akan otomatis diatur ke auto
​
sequential_image_generation_options
object
Sequential pembuatan gambar optionsTersedia saat sequential_image_generation diatur ke autoProperti:
  • max_images (integer): Tentukan jumlah gambar yang akan dibuat
Contoh:
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 4
}
​
watermark
boolean
default:"false"
Apakah akan menambahkan watermark ke gambar yang dihasilkan
  • true: Tambahkan watermark
  • false: Tanpa watermark (default)

​
Respons

​
code
integer
Kode status respons
​
data
array
Array data respons